GitHub Actions の workflow run とは？

workflow run は workflow の 1 回の実行です。各実行は独自のログ、ステータス、ID、試行番号を持ちます。

イベントが workflow をトリガーするたびに、GitHub は workflow run を作成します。これは監視、検査、再実行ができる具体的なインスタンスです。Actions タブに一覧表示されるオブジェクトです。

それは何か

workflow run は workflow の 1 回の呼び出しです。実行されたジョブ、そのログとステータス、そしてトリガーしたイベントやコミットといったメタデータをまとめます。

どう動くか

トリガーが発火すると、GitHub は一意の run_id で実行を記録し、ジョブをランナーにスケジュールし、ジョブが完了するにつれて実行のステータスを成功、失敗、キャンセルに更新します。

steps:
  - run: echo "Run ${{ github.run_id }} attempt ${{ github.run_attempt }}"

再実行と試行

失敗した実行を再実行でき、それにより run_attempt が増加します。これは新しいコミットを push せずに一時的な失敗を再試行するのに便利です。

なぜ重要か

workflow run は監査とデバッグの単位です。どのコミットで何が実行され、どんな結果になったかを正確に示します。run ID により、ツールや Latchkey のマネージドランナーはジョブとインフラのイベントを相関付けられます。

関連する概念

run はジョブを含み、トリガーによって生成されます。そのメタデータは github コンテキストを通じて公開されます。

重要なポイント

• workflow run は workflow の 1 回の実行です。
• 一意の run_id と run_attempt を持ちます。
• 実行を再実行すると試行番号が増加します。

関連ガイド