開発者ガイド

注釈

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。まずは、マスター (master)、スレーブ (slave)、ブラックリスト (blacklist)、ホワイトリスト (whitelist) の 4 つの用語の置き換えから始めます。問題のある用語を見つけた場合は、問題を作成するか、プル要求を作成してください。詳細は、弊社の CTO、Chris Wright のメッセージを参照してください。

Ansible 開発者ガイドにようこそ!

本ガイドの対象者

カスタムモジュールまたはプラグインのローカルでの使用、モジュールまたはプラグインの作成、既存のモジュールへの機能の追加、テスト範囲の拡張を行って Ansible を拡張する場合は、このガイドをご利用になれます。モジュールのテストおよびドキュメント化に関する方法についての開発者向けの詳細情報、および主な Ansible リポジトリーに受け入れられるモジュールまたはプラグインを取得するための前提条件が記載されています。

以下の中から、お客様のニーズに最も適したタスクを選んでください。

ユースケースに対応する方法を探している。
- カスタムプラグインまたはモジュールをローカルに追加したいです。
- 選択したユースケースでは、モジュールの開発が適切なアプローチであるかどうかを確認したいです。
- コレクションを開発したいです。
- Ansible が管理するコレクションに貢献したいです。
- コミュニティーが管理するコレクションに貢献したいです。
- ロールをコレクションに移行したいです。
上記の情報を読んで、モジュールを開発したい。
- コーディングを始める前に何を知っておくべきでしょうか。
- Python 開発環境をセットアップしたいです。
- モジュールの記述を開始したいです。
- 特定のモジュールを作成したいです。
  
  ネットワークモジュール
  
  Windows モジュール
- Ansible を新規製品 (例: データベース、クラウドプロバイダー、ネットワークプラットフォーム) と統合する一連の関連モジュールを記述したいです。
コードを改良したいです。
- モジュールコードをデバッグしたいです。
- テストを追加したいです。
- モジュールをドキュメント化したいです。
- ネットワークプラットフォームのモジュールセットを文書化したいです。
- クリーンで使いやすいモジュールコードのための規則とヒントを適用したいです。
- 作成したコードが Python 2 および Python 3 で実行するようにしたいです。
他の開発プロジェクトで作業したいです。
- プラグインを記述したいです。
- Ansible を新しいインベントリーソースに接続したいです。
- 古いモジュールを非推奨にしたいです。
Ansible プロジェクトに貢献したいです。
- Ansible への貢献方法を理解したいです。
- モジュールまたはプラグインに貢献したいです。
- Ansible に参加するための使用許諾契約を理解したいです。

本ガイドをすべて読む場合は、以下に示す順番でページを表示してください。