第4章 Event-Driven Ansible と Red Hat Hybrid Cloud Console の統合

手順

1. 環境を Red Hat Ansible Automation Hub に接続します。

   1. Hybrid Cloud Console で、Ansible Automation Platform > Connect to Hub に移動します。
   2. Offline token で、以下の文字列をコピーします。トークンは 30 日間使用しないと期限切れになります。トークンの有効期限が切れないように、以下のコマンドを定期的に実行してください。
   3. ターミナルウィンドウに、前の手順でコピーした文字列を貼り付けます。

2. Event-Driven Ansible の Red Hat Insights コレクションをインストールするには、以下のコマンドを入力します。

   $ ansible-galaxy collection install redhat.insights_eda

3. Red Hat Insights の要件をインストールするには、root ユーザーとして次のコマンドを入力します。

   # pip3 install -r ~/.ansible/collections/ansible_collections/redhat/insights_eda/requirements.txt

4. 次のコマンドを入力して、redhat.insights_eda が出力に含まれていることを確認します。

   $ ansible-galaxy collection list

   このコマンドの出力例：

   # /home/username/.ansible/collections/ansible_collections
   Collection         Version
   ------------------ -------
   ansible.eda        1.3.8
   community.general  7.0.1
   redhat.insights_eda 1.0.0

5. テキストエディターを使用して、Red Hat Insights コレクションを使用するシンプルな Ansible ルールブックを含む YAML ファイルを作成します。たとえば、次の内容を含む simple-rulebook.yaml というファイルを作成します。

   ---
   - name: Listen for events from Red Hat Insights
     hosts: all
     sources:
       - redhat.insights_eda.insights:
     rules:
       - name: Handle Red Hat Insights payload
         condition: event.payload is defined
         action:
           debug:
             msg: "Received: {{ event.payload }}"

   このシンプルな Playbook は、redhat.insights_eda.insights コレクションをソースとして使用します。ペイロード を持つイベントが定義されている場合、event.payload の内容が出力として表示されます。

   ルールブックは、イベントを受信し、Hybrid Cloud Console と通信するために使用されるエンドポイントを公開します。Red Hat Insights アドバイザー、コンプライアンス、および脆弱性サービスの高度な例は、Ansible Automation Hub の Event-Driven Ansible for Red Hat Insights ドキュメントを参照してください。

6. 関連する Playbook を含む YAML ファイルを作成します。たとえば、単純なインベントリーを含む inventory.yaml というファイルを作成します。

   all:

7. ansible-rulebook コマンドを実行して、Event-Driven Ansible リスナーを起動し、新しいイベントをリッスンします。次の例では、このコマンドはデフォルトのポート 5000 で localhost を公開します。

   $ ansible-rulebook --verbose --rulebook simple-rulebook.yml -i inventory.yml

8. 別のターミナルウィンドウで curl コマンドを実行して、Event-Driven Ansible リスナーが正しく設定されていることを確認します。次に例を示します。

   $ curl -H 'Content-Type: application/json' -d "{\"payload\": \"Test incoming event\"}" localhost:5000/endpoint

   この例では、設定が正しい場合、イベントの内容を含む新しいメッセージが EDA リスナーウィンドウに表示されます。

   Received: {'payload': 'Test incoming event'}

9. Hybrid Cloud Console で、Settings > Integrations に移動します。
10. Reporting & Automation タブを選択します。
11. Add integration をクリックします。
12. Event-Driven Ansible をインテグレーションタイプとして選択し、次に Next をクリックします。
13. Integration name フィールドに、統合の名前を入力します (例: My EDA Integration)。

14. Ansible ルールブックで設定した URL を Endpoint URL フィールドに入力します。これは、Event-Driven Ansible リスナーを指すエンドポイントです。

    注記

    Endpoint URL には http:// または https:// を含める必要があります (例: https://<eda_hostname>:5000/endpoint)。

    必要に応じて、組織のセキュリティー管理者に Red Hat Hybrid Cloud Console へのアクセスを設定するよう依頼してください。

15. オプション: シークレットトークン が設定されている場合は入力します。

    注記

    Secret トークンは、インテグレーションエンドポイントに送信されるデータを保護するために必要であり、Hybrid Cloud Console をサードパーティーアプリケーションと統合するときは常に使用する必要があります。

16. Next をクリックします。
17. インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。

1. Integrations > Reporting & Automation ページの Event-Driven Ansible インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
2. Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
3. Event-Driven Ansible リスナーターミナルで、Hybrid Cloud Console から送信されたメッセージを確認します。
4. Hybrid Cloud Console で、Notifications > Event Log に移動し、Integration: Event-Driven Ansible イベントが緑色のラベルでリストされていることを確認します。