2.3. Event-Driven Ansible と Red Hat Hybrid Cloud Console の統合
Event-Driven Ansible を使用すると、Red Hat Insights などの Hybrid Cloud Console のケイパビリティーを利用して、発生する可能性のある問題や推奨事項についてインベントリーを継続的に分析できます。Event-Driven Ansible は、イベントのソースをルール経由で対応するアクションに接続します。
Hybrid Cloud Console 通知サービスとのインテグレーションでは、Event-Driven Ansible を使用してアクションをトリガーします。各アカウントは、イベントの種類に応じてアクションを実行できる機能とともに、これらのイベントを誰がどのように受信できるかを設定します。
サポートへの問い合わせ
Hybrid Cloud Console と Event-Driven Ansible とのインテグレーションに問題がある場合は、Red Hat に連絡してサポートを依頼してください。Help (? アイコン) > Open a support case をクリックするか、? > Support options から他のオプションを表示し、Hybrid Cloud Console から直接 Red Hat サポートケースを開くことができます。
2.3.1. Red Hat Hybrid Cloud Console と統合するための Event-Driven Ansible 2.5 の設定 リンクのコピーリンクがクリップボードにコピーされました!
Event-Driven Ansible 2.5 を設定して、Red Hat Hybrid Cloud Console またはサードパーティーアプリケーションからイベント通知を受信できます。
前提条件
- Ansible Automation Platform と Event-Driven Ansible 2.5 がインストールされた環境がある。
- Hybrid Cloud Console の Organization Administrator または Notifications administrator の権限がある。
- Insights EDA コレクションをソースとして使用するルールブックが少なくとも 1 つ含まれている Github リポジトリーがある。例は、Event-Driven Ansible for Red Hat Insights を参照してください。
手順
- Ansible Automation Platform 2.5 環境で、Automation Decisions > Infrastructure > Credentials に移動します。
- Credentials ページで Create credential をクリックします。
- Create credential ページで、認証情報の名前を入力します (例: Red Hat Insights)。
- Organization タイプを選択し、Credential type で Token Event Stream を選択します。
トークンを入力してコピーします。トークン値は、Hybrid Cloud Console と、Event-Driven Ansible を使用した Ansible Automation Platform 間のトークン認証に使用されます。
注記トークン値には、大文字または小文字、数字、記号を含む任意の文字列を無作為に指定できます。トークンジェネレーターは Web にあります。
-
HTTP Header Key の下に
X-Insight-Tokenを入力します。 - Save credential をクリックします。
- Automation Decisions > Event Streams に移動して、Create event stream をクリックします。
- Create event stream ページで、イベントストリームの名前 (例: Red Hat Insights event stream) を入力します。
- Organization で組織を選択します。
- Event stream type で Token Event Stream を選択します。
- 作成した認証情報 (例: Red Hat Insights) を選択します。
- Create event stream をクリックします。
- イベントストリームページの Details タブで、イベントストリームのエンドポイント URL をコピーします。この URL は、Hybrid Cloud Console で Event-Driven Ansible インテグレーションを設定するときに使用されます。
Github リポジトリーから Ansible ルールブックをインポートします。
- Ansible プロジェクトを作成するには、Red Hat Ansible Automation Platform > Automation Decisions > Projects に移動します。
- プロジェクトの作成 ページで、プロジェクトの名前 (例: Insights) を入力します。
- Source control URL で、Red Hat Insights ルールブックを含む Github リポジトリーの URL を貼り付けて、Create project をクリックします。
- Insights ルールブックを有効するには、Red Hat Ansible Automation Platform > Automation Decisions > Rulebook Activations に移動し、Create rulebook activation をクリックします。
- アクティベーションの名前を入力します (例: Insights rulebook)。
- Organization で、組織を選択します。
- Project で Insights を選択します。
- Rulebook で、リストからルールブックを選択します。
- Event streams の横にある歯車アイコンを選択し、作成したイベントストリームを選択します。
- Descision enviroment で Default Decision Environment を選択し、Create rulebook activation をクリックします。ルールブックのページが表示されます。
- アクティベーションのステータスが Running に変わるまで待ちます。
- Hybrid Cloud Console で、Settings > Integrations に移動します。
- Reporting & Automation タブを選択します。
- Add integration をクリックします。
- Event-Driven Ansible をインテグレーションタイプとして選択し、次に Next をクリックします。
- Integration name フィールドに、統合の名前を入力します (例: My EDA Integration)。
- 先ほどコピーしたイベントストリーム URL を Endpoint URL フィールドに入力します。これは、Event-Driven Ansible リスナーを指すエンドポイントです。Hybrid Cloud Console が HTTP POST イベントを送信するには、このエンドポイント URL にアクセスできる必要があります。Hybrid Cloud Console からの HTTP POST イベントを受け入れるには、ネットワークアクセスまたはファイアウォール、あるいはその両方を設定する必要がある場合があります。
前に作成したシークレットトークンを入力します。
注記シークレットトークンは、インテグレーションエンドポイントに送信されるデータを保護するために必要であり、Hybrid Cloud Console をサードパーティーアプリケーションと統合するときは常に使用する必要があります。
- Next をクリックします。
- インテグレーションの詳細を確認し、Submit をクリックしてインテグレーションを有効にします。
Event-Driven Ansible インテグレーションが、Integrations > Reporting & Automation ページに表示されるようになりました。Last connection attempt のステータスが Ready になっている場合は、接続がコンソールからの通知を受け入れることができることを示しています。
検証
Event-Driven Ansible が Hybrid Cloud Console に正しく接続されていることを確認するためのテスト通知を作成します。
- Integrations > Reporting & Automation ページの Event-Driven Ansible インテグレーションの横にあるオプションアイコン (⋮) をクリックし、Test をクリックします。
- Integration Test 画面でメッセージを入力し、Send をクリックします。フィールドを空白のままにすると、Hybrid Cloud Console はデフォルトのメッセージを送信します。
- Ansible Automation Platform with Event-Driven Ansible で、Automation Decisions > Event Streams に移動します。
- イベントストリームの Details タブで、Events received の数が増加していることを確認します。
- Hybrid Cloud Console で、Notifications > Event Log に移動し、Integration: Event-Driven Ansible イベントが緑色のラベルでリストされていることを確認します。
2.3.2. Event-Driven Ansible インテグレーションの動作グループの作成 リンクのコピーリンクがクリップボードにコピーされました!
動作グループは、Event-Driven Ansible などの外部サービスに送る通知を、特定のイベントが通知サービスによって受信されたときに定義します。イベントは、Red Hat Hybrid Cloud Console サービスから動作グループにリンクできます。
前提条件
Organization Administrator または Notifications administrator のパーミッションを持つユーザーとして Hybrid Cloud Console にログインしている。
注記メールアドレスが Red Hat ログインと同じでない場合、メールアドレスで Hybrid Cloud Console にログインすることはできません。詳細は、ログインの検索 を参照してください。
- Event-Driven Ansible インテグレーションと Hybrid Cloud Console は、「Red Hat Hybrid Cloud Console と統合するための Event-Driven Ansible 2.5 の設定」 の説明どおりに設定されます。
手順
- Hybrid Cloud Console で、Settings > Notifications に移動します。
- Notifications で Configure Events を選択します。
- イベント通知動作を設定するアプリケーションバンドルタブ (Red Hat Enterprise Linux、Console、または OpenShift) を選択します。
- Behavior Groups タブをクリックします。
- Create behavior group ウィザードを開くには、Create new group をクリックします。
- 動作グループの名前を入力し、Next をクリックします。
- Actions and Recipients の手順で、Actions ドロップダウンリストから Integration: Event-Driven Ansible を選択します。
- Recipient ドロップダウンリストから、作成したインテグレーションの名前 (My EDA Listener など) を選択し、Next をクリックします。
- Associate event types ステップで、通知を送信する 1 つ以上のイベント (たとえば、Advisor: New recommendation) を選択し、Next をクリックします。
- 動作グループの設定を確認し、Finish をクリックします。新しい動作グループが Notifications ページに表示されます。
検証
-
Hybrid Cloud Console 通知をトリガーするイベントを作成します。たとえば、登録済みシステムで
insights clientコマンドを実行して、Advisor からの新しい推奨イベントをトリガーできます。 Hybrid Cloud Console が正常に統合されたことを確認するには、Hybrid Cloud Console で Settings > Notifications > Event Log に移動し、トリガーした最後のイベントに Integrations: Event-Driven Ansible のラベルが表示されていることを確認します。
- ラベルが緑色であれば、通知は成功しています。
- ラベルが赤色の場合は、ストリームが Event-Driven Ansible で適切に作成および公開されていること、および Hybrid Cloud Console 統合設定で正しいストリーム URL が設定されていることを確認してください。
詳細は、通知ドキュメントの 通知失敗のトラブルシューティング を参照してください。