第5章 Automation Controller のジョブ
ジョブは、Ansible Playbook をホストのインベントリーに対して起動する Automation Controller のインスタンスです。
Jobs リストビューには、ジョブとそのステータスのリストが表示され、completed successfully、failed または active (running) ジョブとして表示されます。デフォルトのビューは折りたたまれて (コンパクト)、ジョブ名、ステータス、ジョブタイプ、開始時刻、終了時刻が表示されます。矢印 アイコンをクリックして、展開し、詳細を表示します。このリストをさまざまな基準で並べ替えたり、検索を実行して目的のテンプレートをフィルタリングしたりできます。
この画面から、次のタスクを実行できます。
- 特定のジョブの詳細と標準出力を表示する
- ジョブを再起動する
- 選択したジョブをキャンセルまたは削除する
再起動操作は、Playbook の実行の再起動にのみ適用され、システムジョブ、プロジェクト/インベントリーの更新、ワークフロージョブなどには適用されません。ジョブが再起動されると、Jobs Output ビューが表示されます。任意のタイプのジョブを選択すると、そのジョブの Jobs Output ビューが表示され、さまざまな基準でジョブをフィルターできます。
- Search output リストの Event オプションを使用すると、エラー、ホストの障害、ホストの再試行、スキップされた項目など、目的のイベントでフィルタリングできます。フィルターには、必要な数のイベントを含めることができます。検索の使用方法の詳細は、検索 セクションを参照してください。
5.1. インベントリー同期ジョブ
インベントリー同期が実行されると、結果が Output タブに表示されます。
インベントリー同期の詳細は、構築型インベントリー を参照してください。
使用すると、Ansible CLI に同じ情報が表示されます。これはデバッグに役立ちます。ANSIBLE_DISPLAY_ARGS_TO_STDOUT
パラメーターは、すべての Playbook 実行に対して False
に設定されます。このパラメーターは Ansible のデフォルトの動作と一致しており、特定の機密モジュールパラメーターが stdout
に漏洩することを避けるために、Job Detail インターフェイスのタスクヘッダーにタスク引数が表示されません。以前の動作を復元するには、AWX_TASK_ENV
設定で ANSIBLE_DISPLAY_ARGS_TO_STDOUT
を True
に設定します。
詳細は、Ansible ドキュメントの ANSIBLE_DISPLAY_ARGS_TO_STDOUT を参照してください。
、 、ジョブ出力のダウンロード 、またはジョブの削除 を実行できます。
関連ジョブの実行中にインベントリーの更新を実行できます。大規模なプロジェクト (約 10 GB) がある場合、/tmp
のディスク領域が問題になる可能性があります。
5.1.1. インベントリー同期の詳細
Details タブにアクセスして、ジョブの実行に関する詳細を表示します。
実行したジョブの次の詳細を表示できます。
ステータス: 次のいずれかになります。
Pending: インベントリー同期は作成されましたが、まだキューに登録されておらず、開始されていません。インベントリーソースの同期に限らず、すべてのジョブは、システムによる実行の準備が整うまで保留状態になります。インベントリーソース同期の準備ができていない理由には次のようなものがあります。
- 現在実行中の依存関係 (次のステップを実行する前に、すべての依存関係が完了する必要があります)。
- 設定された場所で実行するには容量が不十分です。
- Waiting: インベントリーの同期はキューに入れられており、実行を待機中です。
- Running: インベントリーの同期が進行中です。
- Successful: インベントリー同期ジョブが成功しました。
- Failed: インベントリーの同期ジョブが失敗しました。
- Inventory: 関連付けられたインベントリーグループの名前。
- Source: クラウドインベントリーのタイプ。
- Inventory Source Project: このインベントリー同期ジョブのソースとして使用されるプロジェクト。
- Execution Environment: 使用される実行環境。
- *Execution node: ジョブの実行に使用されるノード。
- Instance Group: このジョブで使用されるインスタンスグループの名前 (コントローラーはデフォルトのインスタンスグループ)。
これらの項目を選択すると、対応するジョブテンプレート、プロジェクト、およびその他のオブジェクトを表示できます。