Event-Driven Ansible Controller ユーザーガイド

手順

1. Event-Driven Ansible Controller ダッシュボードにログインします。
2. ナビゲーションパネルから Resources → Credentials を選択します。
3. Create credential をクリックします。

4. 以下を入力します。

   Name

   名前を入力します。

   Description

   このフィールドは任意です。

   認証情報タイプ

   利用できるオプションは、GitHub パーソナルアクセストークン、GitLab パーソナルアクセストークン、またはコンテナーレジストリーです。

   Username

   ユーザー名を挿入します。

   Token

   宛先への認証を可能にするトークンを挿入します。

   注記

   コンテナーレジストリーを使用している場合、トークンフィールドは、レジストリープロバイダーに応じてトークンまたはパスワードにすることができます。Ansible Automation Platform ハブレジストリーを使用している場合は、そのパスワードを token フィールドに挿入します。

5. Create credential をクリックします。

手順

1. 以下のいずれかの方法を使用して、認証情報を編集します。

   • Credentials リストビューで、必要な認証情報の横にある Edit credential アイコンをクリックします。
   • Credentials リストビューで認証情報の名前を選択し、Edit credential をクリックします。
2. 適切な詳細を編集し、Save credential をクリックします。

手順

1. 以下のいずれかの方法を使用して、認証情報を削除します。

   • Credentials リストビューで、必要な認証情報の横にある More Actions アイコン ⋮ をクリックし、Delete credential をクリックします。
   • Credentials リストビューで認証情報の名前を選択し、Edit credential の横にある More Actions アイコン ⋮ をクリックして、Delete credential をクリックします。
2. ポップアップウィンドウで、Yes, I confirm to delete this credential を選択します。
3. Delete credential をクリックします。

手順

1. Event-Driven Ansible Controller ダッシュボードにログインします。
2. ナビゲーションパネルから、Projects → Create project を選択します。

3. 以下を入力します。

   Name

   プロジェクト名を入力します。

   Description

   このフィールドは任意です。

   SCM type

   Git のみ使用できます。

   SCM URL

   GitHub や GitLab などのリポジトリーの HTTP[S] プロトコルアドレス。

   注記

   プロジェクトの作成後に SCM URL を編集することはできません。

   Credential

   このフィールドは任意です。これは、SCM URL を利用するために必要なトークンです。

   オプション

   Verify SSL オプションはデフォルトで有効になっています。このオプションが有効になっていると、プロジェクトのインポート時に SSL が HTTPS で検証されます。

   注記

   自己署名付き証明書を使用するローカルリポジトリーがある場合は、このオプションを無効にできます。

4. Create Project を選択します。

手順

1. Projects リストビューで、目的のプロジェクトの横にある More Actions アイコン ⋮ を選択します。
2. Edit project を選択します。
3. 必要な変更を入力し、Save project を選択します。

手順

1. Projects リストビューで、目的のプロジェクトの横にある More Actions アイコン ⋮ を選択します。
2. Delete project を選択します。
3. ポップアップウィンドウで、Yes, I confirm to delete this project を選択します。
4. Delete project を選択します。

手順

1. Event-Driven Ansible Controller ダッシュボードに移動します。
2. ナビゲーションパネルから Decision Environments を選択します。

3. 以下を入力します。

   Name

   名前を入力します。

   Description

   このフィールドは任意です。

   Image

   これは、コンテナーレジストリー、イメージ名、およびバージョンタグを含む完全なイメージの場所です。

   Credential

   このフィールドは任意です。これは、決定環境イメージを利用するために必要なトークンです。

4. Create decision environment を選択します。

手順

1. Event-Driven Ansible Controller ダッシュボードに移動します。
2. 上部のナビゲーションパネルからプロファイルを選択します。
3. User details に移動します。
4. Controller Tokens → Create controller token を選択します。

5. 以下を入力します。

   Name

   名前を入力します。

   Description

   このフィールドは任意です。

   Token

   Automation Controller でトークンを作成します。トークンの作成の詳細は、Automation Controller ユーザーガイドの ユーザー - トークン セクションを参照してください。

   注記

   トークンは書き込みスコープ内にある必要があり、割り当てられたユーザーの場合は、ジョブおよびワークフローテンプレートを実行する権限を持っている必要があります。

6. Create controller token を選択します。

手順

1. Event-Driven Ansible Controller ダッシュボードに移動します。
2. ナビゲーションパネルから Rulebook Activations を選択します。

3. 以下を入力します。

   Name

   名前を入力します。

   Description

   このフィールドは任意です。

   Project

   プロジェクトはルールブックの論理的なコレクションです。

   Rulebook

   選択したプロジェクトに応じてルールブックが表示されます。

   Decision environment

   決定環境は、Ansible ルールブックを実行するためのコンテナーイメージです。

   注記

   Event-Driven Ansible コントローラーでは、Decision environment のプルポリシーをカスタマイズできません。デフォルトでは、always ポリシーの動作に従います。アクティベーションが開始されるたびに、システムはイメージの最新バージョンを取得しようとします。

   Restart policy

   これは、ルールブックを再起動する条件を決定するためのポリシーです。

   • Policies:

     1. Always: ルールブック終了時に再起動します。
     2. Never: 終了時にルールブックを再起動しません。
     3. On failure: 失敗した場合にのみ再起動します。

   Rulebook activation enabled?

   これを選択すると、ルールブックアクティベーションが自動的に有効になります。

   Variables

   ルールブックの変数は JSON/YAML 形式です。内容は、ansible-rulebook コマンドの --vars フラグによって渡されるファイルと同等です。

4. Create rulebook activation をクリックします。

1. 行レベルのスイッチを選択して、選択したルールブックを有効または無効にします。
2. ポップアップウィンドウで、Yes, I confirm that I want to enable/disable these X rulebook activations 選択します。
3. Enable/Disable rulebook activation を選択します。

1. Rulebook Activation enabled/disabled トグルの横にある More Actions アイコン ⋮ を選択します。
2. Restart rulebook activation を選択します。
3. ポップアップウィンドウで、Yes, I confirm that I want to restart these X rulebook activations を選択します。
4. Restart rulebook activations を選択します。

1. Rulebook Activation enabled/disabled トグルの横にある More Actions アイコン ⋮ を選択します。
2. Delete rulebook activation を選択します。
3. ポップアップウィンドウで、Yes, I confirm that I want to delete these X rulebook activations を選択します。
4. Delete rulebook activations を選択します。

手順

1. サービスを公開するためのルートを (OpenShift Container Platform 上に) 作成します。以下は、決定環境 Pod のポート 5000 で POST を要求する ansible-rulebook ソースのルートの例です。

   kind: Route
   apiVersion: route.openshift.io/v1
   metadata:
     name: test-sync-bug
     namespace: dynatrace
     labels:
       app: eda
       job-name: activation-job-1-5000
   spec:
     host: test-sync-bug-dynatrace.apps.aap-dt.ocp4.testing.ansible.com
     to:
       kind: Service
       name: activation-job-1-5000
       weight: 100
     port:
       targetPort: 5000
     tls:
       termination: edge
       insecureEdgeTerminationPolicy: Redirect
     wildcardPolicy: None

   Copy to Clipboard Toggle word wrap

2. ルートを作成したら、ルート URL へのポスト を使用してテストします。

   curl -H "Content-Type: application/json" -X POST
   test-sync-bug-dynatrace.apps.aap-dt.ocp4.testing.ansible.com -d
   '{}'

   Copy to Clipboard Toggle word wrap
   注記

   ポートはルート (targetPort) で指定されているため、必要ありません。

手順

1. 次のコマンドを実行して、クラスター上の特定のサービスのポートを公開します。

   kubectl port-forward svc/<ACTIVATION_SVC_NAME> 5000:5000

   Copy to Clipboard Toggle word wrap

2. localhost:5000 に対して HTTP リクエストを実行して、ルールブックをトリガーします。

   curl -H "Content-Type: application/json" -X POST test-sync-bug-dynatrace.apps.aap-dt.ocp4.testing.ansible.com -d '{}'

   Copy to Clipboard Toggle word wrap

手順

1. ナビゲーションパネルから Rule Audit を選択します。
2. 目的のルールを選択すると、Details タブが表示されます。

手順

1. ナビゲーションパネルから Rule Audit を選択します。
2. 目的のルールを選択すると、Details タブが表示されます。アクションをトリガーしたすべてのイベントを表示するには、Events タブを選択します。選択すると、アクションをトリガーしたイベントが表示されます。
3. イベントを選択すると、Event log が Source type と Timestamp とともに表示されます。

手順

1. ナビゲーションパネルから Rule Audit を選択します。
2. 目的のルールを選択すると、Actions タブが表示されます。

1. ルールブックの同時アクティベーションの数
2. Event-Driven Ansible Controller が受信したイベントの数