25.3. Playbook 実行ジョブ
Playbook が実行されると、結果が Output タブに表示されます。使用すると、Ansible CLI に同じ情報が表示されます。これはデバッグに役立ちます。
イベントの概要には、この Playbook の一部として実行される次のイベントが表示されます。
- この Playbook が実行された回数が Plays フィールドに表示されます。
- この Playbook に関連付けられたタスクの数は、Tasks フィールドに表示されます。
- この Playbook に関連付けられているホストの数が Hosts フィールドに表示されます。
- Elapsed フィールドで Playbook の実行を完了するのにかかった時間
イベントの横にあるアイコンを使用すると、再起動 ( )、ジョブ出力のダウンロード ( )、またはジョブの削除 ( ) を実行できます。
Output ビューのホストステータスバーのセクションにマウスをかざすと、そのステータスに関連付けられたホストの数が表示されます。
Playbook ジョブの出力には、Jobs Templates ページの Jobs タブからジョブを起動した後もアクセスできます。出力内の項目タスクをクリックして、ホストの詳細を表示します。
25.3.1. 検索
Search を使用して、特定のイベント、ホスト名、およびそれらのステータスを検索します。特定のステータスの特定のホストのみをフィルターするには、次の有効なステータスのいずれかを指定します。
- ok
- タスクは正常に完了しましたが、ホスト上で変更が実行されなかったことを示します。
- changed
- Playbook タスクが実行されました。Ansible タスクは冪等になるように作成する必要があるため、ホスト上で何も実行せずにタスクが正常に終了する場合があります。このような場合、タスクは ok を返しますが、変更されません。
- failed
- タスクは失敗しました。このホストに対するそれ以降の Playbook の実行は停止されました。
- unreachable
- ホストがネットワークから到達できないか、ホストに関連する別の致命的なエラーがあります。
- skipped
- ホストが目標状態に到達するために変更が必要なかったため、Playbook タスクはスキップされました。
- rescued
- 失敗したタスクが表示してから、レスキューセクションが実行されます。
- ignored
-
ignore_errors: yes
が設定されていて、失敗したタスクを示しています。
これらのステータスは、各 Stdout ペインのホスト概要フィールドと呼ばれる「統計」のグループにも表示されます。
次の例は、到達不能なホストのみを使用した検索を示しています。
検索の使用方法の詳細は、検索 セクションを参照してください。
標準出力ビューには、特定のジョブで発生したイベントが表示されます。デフォルトでは、詳細が表示されるようにすべての行がデプロイメントされます。すべて折りたたむ ( ) アイコンをクリックして、プレイとタスクのヘッダーのみを含むビューに切り替えます。プラス記号 ( ) アイコンをクリックすると、標準出力のすべての行が表示されます。
特定のプレイまたはタスクの横にある矢印アイコンをクリックすると、その詳細をすべて表示できます。横から下への矢印をクリックして、そのプレイまたはタスクに関連付けられた線をデプロイメントします。矢印をクリックして横の位置に戻り、線を折りたたんで非表示にします。
デプロイメントモードまたは折りたたみモードで詳細を表示する場合は、次の点に注意してください。
- 縮小表示されない行で、対応する行番号と開始時間を含む、表示されたそれぞれの行。
- プレイまたはタスクの完了後のプレイまたはタスクの開始時の展開/折りたたみアイコン。
- 特定のプレイまたはタスクのクエリーを実行する場合、それは完了したプロセスの最後に縮小表示されます。
- 場合によっては、出力が大きすぎて表示できない可能性があることを示すエラーメッセージが表示されます。これはイベントが 4000 を超える場合に発生します。エラーを回避するには、特定のイベントの検索とフィルターを使用します。
Stdout ペインでイベントの行をクリックすると、別のウィンドウに Host Events ウィンドウが表示されます。このウィンドウには、その特定のイベントの影響を受けたホストが表示されます。
Ansible Automation Platform の最新バージョンにアップグレードするには、すべての履歴 Playbook 出力とイベントを段階的に移行する必要があります。この移行プロセスは段階的に行われ、インストールの完了後にバックグラウンドで自動的に実行されます。非常に大量の履歴ジョブ出力 (数十 GB または数百 GB の出力) を含むインストールでは、移行が完了するまでジョブ出力が欠落する可能性があります。最新のデータが出力の先頭に表示され、その後に古いイベントが続きます。
25.3.2. ホストの詳細
Host Details ウィンドウには、選択したイベントの影響を受けるホストと、それに関連するプレイおよびタスクに関する次の情報が表示されます。
- Host
- Status
- Play フィールドでの実行タイプ
- Task のタイプ
- 該当する場合、Ansible Moduke タスク、およびモジュールのすべての引数
JSON 形式で結果を表示するには、JSON タブをクリックします。タスクの出力を表示するには、Standard Out をクリックします。出力からエラーを表示するには、Standard Error をクリックします。
25.3.3. Playbook 実行の出力:
Details タブにアクセスして、ジョブの実行に関する詳細を表示します。
実行したジョブの次の詳細を表示できます。
ステータス: 次のいずれかになります。
- Pending: Playbook の実行は作成されましたが、まだキューに入れられていないか、開始されていません。Playbook の実行だけでなく、すべてのジョブは、システムによって実行される準備ができるまで保留状態になります。Playbook の準備ができていない理由としては、現在実行中の依存関係 (次のステップを実行する前にすべての依存関係が完了している必要がある) に含まれていないか、または設定されている場所で実行するのに十分な容量がないことが考えられます。
- Waiting: Playbook 実行はキューに入れられており、実行を待機中です。
- Running: Playbook 実行が進行中です。
- Successful: 直前の Playbook 実行が成功しました。
- Failed: 直前の Playbook 実行が失敗しました。
- Job Template: ジョブが起動されるジョブテンプレートの名前。
- Inventory: このジョブを実行するために選択されたインベントリー。
- Inventory: 起動したジョブに関連付けられたプロジェクトの名前。
- Project Status: 起動したジョブに関連付けられたプロジェクトのステータス。
- Playbook: このジョブを起動するために使用される Playbook。
- Execution Environment: このジョブで使用される実行環境の名前。
- Container Group: このジョブで使用されるコンテナーグループの名前。
- Credentials: このジョブで使用される認証情報。
- Extra Variables: ジョブテンプレートの作成時に渡される追加変数がここに表示されます。
これらの項目のいずれかを選択すると、対応するジョブテンプレート、プロジェクト、およびその他のオブジェクトが表示されます。