コンソールを使ったアクションの作成

「 Schematics 」アクションを作成し、Cloudリソースに対して実行したい「 Ansible 」プレイブックを指定します。

1. IBM Cloud コンソールにログインする。

2. メニューアイコン > Platform Automation > をクリックします。 Schematics > Ansible をクリックし、 Create playbookに移動します。

   • プレイブックを作る。

     1. プレイブックの名前とアクションの説明を入力します。 名前は最大 128 文字の長さで、英数字、スペース、ダッシュ、およびアンダースコアーを含めることができます。
     2. Ansible プレイブックが保管されている GitHub または GitLab リポジトリーの URL を入力します。 マスター・ブランチ、他のブランチ、またはサブディレクトリーを指す URL を入力できます。 リポジトリーに複数のプレイブックが保管されている場合は、実行するプレイブックを選択する必要があります。 Schematics アクションでは、参照先として一度に 1 つの Playbook を指すように指定できます。 複数の Playbook を実行するには、Playbook ごとに別個のアクションを作成しなければなりません。

     プレイブックをお持ちでない方は、 サンプルのプレイブックをお試しください。

     3. オプション： ブランチ（オプション ）とフォルダ（オプション ）を入力します。
     4. オプション: プライベート GitHub リポジトリーを使用する場合は、個人用アクセス・トークンを入力します。 個人用アクセス・トークンは、プライベート GitHub リポジトリーを認証して Ansible プレイブックにアクセスするために使用されます。 アクセストークンの作成方法の詳細については、「 CLI用の個人用アクセストークンの作成 」を参照してください。

     詳細については、 Git リポジトリからのクローン作成において 許可およびブロックされているファイル拡張子 をご確認ください。 テンプレートを安全に検証およびクローンするには、「 Open reference picker 」をクリックして、 Secrets Manager のキー参照を選択してください。 詳細については、「 Secrets Manager インスタンスの作成 」を参照してください。

   • 詳細情報

     1. オプション: アクションに追加したいタグを入力します。 タグは、アクションのクイック検索に役立ちます。
     2. アクションを作成する**「リソース・グループ」**を選択します。
     3. アクションを作成する**「ロケーション」**を選択します。 このロケーションに基づいて、アクションが実行される場所とアクション・データが保管される場所が決まります。 Dallas や Frankfurt などの地理を選択できます。 地域を選択した場合は、その地域内で利用可能なロケーションが Schematics によって選択されます。 アクションの作成後はロケーションを変更できないため、このロケーションにアクション・データを保管できることを確認してください。 詳しくは、 情報はどこに保存されている のか？ Ansible プレイブックを実行するクラウドリソースの場所とは、アクションの実行場所が独立していることを確認してください。

   • インベントリーの選択 Ansible のプレイブックを実行するホストグループを定義できます。

     1. **「インベントリーの作成」**をクリックします。

     2. インベントリの名前を入力してください。

     3. リモートホストの要件に応じて、 接続タイプを SSH または WinRM から選択します。 デフォルトはSSHです。

        接続タイプは、リモート・ホストへの接続に SSH と WinRM の両方をサポートする。 SSH 、Bastionホストアクセスが設定されていることを確認する。 WinRM 、Windowsリモートホストとの接続に使用される。 現在、 WinRM は、公開されている IPs を備えたWindowsシステムのみをサポートしており、バスティオンホストへのアクセスはサポートしていません。

     4. location を確認し、インベントリを作成する Resource group を選択します。

     5. **「ホスト・グループの作成」**をクリックします。

     6. ホスト・グループの名前を入力し、ホスト・グループに追加するターゲット・ホストをプロビジョンした Schematics ワークスペースを選択します。

     7. オプション: **「照会の追加 (Add query)」**をクリックして、照会に条件をさらに追加し、ホスト・グループに追加されるターゲット・ホストの数を制限します。 リソース名またはタグを使用して、ホストを特定することもできます。 詳しくは、サポートされているリソース照会を参照してください。

     8. Add another condition] をクリックし、手順6～8を繰り返してホストグループを追加します。

     9. オプション： Define manually タブをクリックし、プレイブックが動作するホストとホストグループを定義する。

     10. ファイル] オプションで、.iniファイル形式を 使用してホストの詳細を入力します。

     11. テーブル・リストから、リソース・インベントリーに含めるホスト・グループを選択します。

     12. インベントリの作成] をクリックして、プレイブックが動作するホストとホストグループを定義するインベントリファイルを定義します。

3. リソース・インベントリ表から、既存のリソース・インベントリを選択し、 Edit アイコンをクリックします。

   • Manage Credentials をクリックして、インベントリ認証情報を構成します。 詳細については、 資格情報の 管理を参照してください。
   • Manage Variables をクリックして、インベントリ変数を設定します。 詳細については、 変数の管理を 参照してください。
   • 削除をクリックしてインベントリを削除します。

4. 「作成」 をクリックします。 アクションが「 Normal 」の状態として作成され、「 詳細 」セクションに移動します。

5. Check actionをクリックして、実行しようとしているタスクとリソースがプレイブックにリンクされていることを確認します。 アクション履歴セクションを監視して、ログで結果を見ることができます。 このチェックでは、実行しようとしているタスクとリソースがプレイブックに正しくリンクされていることを確認する。

   Schematics アクションを実行中のジョブは削除または停止できません。 アクションを変更するには、ジョブの完了を待ち、設定を変更してから、「 アクションの確認 」または「 アクションの実行 」を再度クリックしてください。

6. **「アクションの実行」をクリックして、アクションを実行します。 アクションの進行状況をモニターするには、「ジョブ」**ページのログを確認します。 30 secondsごとに、ジョブ・ログが自動的に最新表示されます。

CLIを使ったアクションの作成

1. ローカルのCLIインターフェイスから、 Schematics プラグインを設定します。
2. ibmcloud schematics action create コマンドを使用してアクションを作成します。
3. ibmcloud schematics inventory create コマンドを使用してインベントリを作成します。
4. ログをチェックして、作成が成功したことを確認する。

APIを使用したアクションの作成

1. IAM アクセス トークンを取得し、 Schematics で認証します。
2. オプション： POSTリクエストを 送信してアクションを作成します。
3. POSTリクエストを 送信してインベントリを作成します。
4. レスポンス・ステータスをチェックし、作成が成功したことを確認する。