開発者ガイド¶

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

本ガイドの対象者

ローカルでカスタムモジュールまたはプラグインを使用して Ansible を拡張する、モジュールまたはプラグインを作成する、既存のモジュールに機能を追加する、またはテストの対象を広げる場合は、このガイドが役立ちます。開発者向けの詳細な情報として、モジュールのテストおよびドキュメント方法と、モジュールまたはプラグインをメインの Ansible リポジトリーで許可するための前提条件を記載しました。

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

ユースケースに対応する方法を探している。
- ローカルにカスタムプラグインまたはモジュールを追加したい。
- 私のユースケースではモジュールを開発することが適切なアプローチであるかどうかを知りたい。
- コレクションを開発したい。
上記の情報を読んで、モジュールを開発したい。
- コーディングを始める前に何を知っておくべきか。
- Python 開発環境を設定したい。
- モジュールの作成を開始したい。
- 特定のモジュールを作成したい。
  
  ネットワークモジュール <developing_modules_network>
  
  Windows モジュール <developing_modules_general_windows>
  
  Amazon モジュール <AWS_module_development>
  
  OpenStack モジュール <OpenStack_module_development>
  
  oVirt/RHV モジュール <oVirt_module_development>
  
  VMware モジュール <VMware_module_development>
- Ansible を新製品 (データベース、クラウドプロバイダー、ネットワークプラットフォームなど) と統合する一連の関連モジュールを記述したい。
コードを改良したい。
- モジュールコードをデバッグしたい。
- テストを追加したい。
- モジュールを文書化したい。
- ネットワークプラットフォーム用のモジュールセットを文書化したい。
- 記述方法が適切で使用可能なモジュールコードの規則とヒントに従いたい。
- コードが Python 2 および Python 3 で実行することを確認したい。
他の開発プロジェクトで作業したい。
- プラグインを記述したい。
- インベントリーの新しいソースに Ansible を接続したい。
- 古いモジュールを廃止したい。
Ansible プロジェクトに貢献したい。
- Ansible への貢献方法を理解したい。
- モジュールまたはプラグインを提供したい。
- Ansible への貢献に関する使用許諾契約を理解したい。

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