3.14. ルールブックアクティベーションの作成および実行
Event-Driven Ansible では、ルールブックアクティベーションは、特定のルールブックを実行する決定環境によって定義され、バックグラウンドで実行されるプロセスです。
3.14.1. ルールブックアクティベーションの設定 リンクのコピーリンクがクリップボードにコピーされました!
ルールブックの有効化を設定するには、この手順に従ってください。
前提条件
- プロジェクトを設定している。
- 決定環境を設定している。
手順
-
ナビゲーションパネルから、
を選択します。 - をクリックします。
以下の情報を入力します。
- 名前: 名前を入力してください。
- 説明: この項目は任意です。
- 組織: この項目は任意です。
- プロジェクト: この項目は任意です。
- ルールブック: ルールブックは、選択したプロジェクトに応じて表示されます。
認証情報: このルールブックの有効化に使用する認証情報を 0 個以上選択してください。このフィールドは任意です。
注記このフィールドに表示される認証情報は、ルールブックアクティベーションに基づいてカスタマイズされています。表示される認証情報のタイプは、Vault、Red Hat Ansible Automation Platform、または作成したカスタム認証情報タイプだけです。認証情報の詳細は、「自動化決定の使用」ガイドの 認証情報 を参照してください。
決定環境: 決定環境とは、Ansible ルールブックを実行するためのコンテナーイメージのことです。
注記Event-Driven Ansible Controller では、決定環境のプルポリシーをカスタマイズすることはできません。デフォルトでは、常に ポリシーに従う動作になります。アクティベーションが開始されるたびに、システムはイメージの最新バージョンを取得しようとします。
再起動ポリシー: これは、ソースプラグインを実行しているコンテナープロセスが終了した後に、アクティベーションをどのように再起動するかを決定するポリシーです。以下のオプションから選択します。
- 常に: これは、ルールブックのアクティベーションが正常に終了したかどうかに関わらず、即座に再開します。また、最大で 5 回まで発生します。
- しない: コンテナープロセスが終了しても、ルールブックのアクティベーションは再起動されません。
- 失敗時: デフォルトでは、コンテナープロセスが失敗した場合にのみ、60 秒後にルールブックのアクティベーションが再開され、最大 5 回まで発生します。
ログレベル: このフィールドは、ログに記録されるイベントの重要度とコンテンツの種類を定義します。次のいずれかのオプションを選択します。
- エラー: アクティベーションの 履歴 タブに表示されるエラーメッセージを含むログ。
- 情報: ルールブックの有効化に関する有用な情報 (成功または失敗、トリガーされたアクション名とその関連アクションイベント、エラーなど) を含むログ。
- デバッグ: デバッグ段階でのみ有用な情報を含むログであり、実稼働環境ではほとんど価値がない可能性があります。このログレベルでは、エラーデータとログレベルデータの両方が対象となります。
- サービス名: これは、アクティベーションによってポートが公開される場合に、Kubernetes が受信接続を設定するためのサービス名を定義します。このフィールドは任意です。
- ルールブックの有効化は有効になっていますか?: ルールブックの有効化を自動的に有効にするには、このトグルをオンにしてください。
-
変数: ルールブックの変数は JSON または YAML 形式です。その内容は、ansible-rulebook コマンドの
--varsフラグで渡されるファイルと同等のものになります。 - オプション: ルール監査で自分のイベントを表示したくない場合は、監査イベントをスキップ オプションをオンにしてください。
をクリックします。
ルールブックの有効化が完了しました。ルールブックの有効化は、ルールブックの有効化 ページで管理できます。
注記ソースプラグインのシャットダウンが原因で、ルールブックが正常に終了するまでに一定の時間かかることがあります。ルールブックアクティベーションがシャットダウンすると、待機中のタスクがすべてキャンセルされ、アクティベーションのログに info レベルのメッセージが送信されます。詳細は、Rulebooks を参照してください。
検証
新しいルールブックの有効化を保存すると、ルールブックの有効化の詳細ページが表示され、保留中、実行中、または 失敗の いずれかのステータスが表示されます。そこから、または ルールブックの有効化リスト ビューから、再起動または削除できます。
3.14.1.1. ルールブックアクティベーションのリストビュー リンクのコピーリンクがクリップボードにコピーされました!
ルールブックの有効化 ページでは、作成したルールブックの有効化状況と、ステータス、ルールブックに含まれる ルールの数、発火回数、再起動回数 を確認できます。
ステータス が 実行中 の場合、ルールブックの有効化がバックグラウンドで実行されており、ルールブックで宣言されたルールに従って必要なアクションが実行されていることを意味します。
ルールブックの有効化 リストから有効化を選択すると、より詳細な情報が表示されます。
実行されたすべてのアクティベーションについて、詳細 タブと 履歴 タブを表示することで、何が起こったのかをより詳しく知ることができます。