Playbook での Ansible コレクションの参照

Ansible コレクションは、プレイブック、モジュール、ロールなどの再利用可能な Ansible リソースのグループで、プレイブックにインストールして使用することができます。 コレクションは Ansible Galaxy リポジトリで利用可能です。

Ansible 役割と同様、コレクションには、GitHub リポジトリー内の特定のフォルダー構造が必要となります。

Schematics プレイブックでコレクションを使用するには、次の手順に従います

1. Ansible Galaxyをブラウズして、プレイブックで使用したいコレクションを見つけます。

2. requirements.yml ファイルを作成し、 Ansible Galaxy からインストールするコレクションを指定します。 ファイル構造は Ansible のドキュメントに 従うこと。 community.kubernetes。

   collections:
     - name: community.kubernetes
       version: 0.9.0
   

3. GitHub リポジトリに collections フォルダーを追加し、playbook に相対するようにし、このフォルダー内に requirements.yml ファイルを配置します。

   ├── collections
           └── requirements.yml
   ├── playbook.yaml
   ├── README.md
   

4. Playbook でコレクションのリソースを参照します。 詳しくは、 Ansible のドキュメントを参照。 Schematics でシームレスに実行できるように、プレイブックのフォルダ構造が要件に準拠し、コレクションを適切に参照していることを確認してください。

Ansible プレイブックを準備する Schematics

Schematics で Ansible プレイブックを実行する前に、以下の点を考慮してください：

• Ansible プレイブックを GitHub または GitLab リポジトリに保存する。
• Ansible リソースインベントリにターゲットホストを指定する場合は、制限に注意してください。 詳細については、 Schematics アクションのための資源インベントリーの作成に関する ガイドラインを参照のこと。
• プレイブックが Schematics でサポートされている Ansible バージョンと互換性があることを確認してください。 サポートされているバージョンを確認するには ibmcloud schematics version コマンドを実行する。
• オプションとして、 IBM 提供の Ansible プレイブック のいずれかを使用して、 Schematics の Ansible プレイブックの機能を調べます。

次のステップ

Ansible プレイブックの前提条件と準備ステップを理解したら、次のステップは Schematics アクションを作成 することだ。 このプロセスでは、 Ansible プレイブックを指定し、リソース・インベントリを構成し、必要な認証情報や変数を設定する。 Schematics アクションを作成するガイドに従ってください。