ワークフローとジョブの再実行

ワークフローとジョブの再実行について

ワークフローまたはワークフロー内のジョブの再実行では、ワークフローの実行をトリガーした元のイベントと同じ GITHUB_SHA (コミット SHA) と GITHUB_REF (Git ref) が使われます。ワークフローまたはワークフロー内のジョブは、最初の実行から最大 30 日後まで再実行できます。ワークフローまたはワークフロー内のジョブを再実行するときは、その再実行に対してデバッグログを有効にできます。これにより、再実行でランナー診断ログとステップデバッグログが有効になります。デバッグログについて詳しくは、「デバッグログを有効にする」をご覧ください。

ワークフロー内のすべてのジョブを再実行する

ご自分のエンタープライズで、リポジトリのメインページへ移動します。 1. リポジトリ名の下の [Actions] (アクション) をクリックします。 1. 左サイドバーで、表示するワークフローをクリックします。 1. ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。

1. ワークフローの右上隅にある [ ジョブの実行] ドロップダウンメニューから [Re-run all jobs] (すべてのジョブの再実行) を選びます。

失敗したジョブがない場合、 [ Re-run all jobs] (すべてのジョブの再実行) ドロップダウンメニューは表示されません。代わりに、 [すべてのジョブを再実行する] をクリックします。

1. ワークフローの右上隅にある [ジョブの再実行] ドロップダウンメニューを使用して、 [すべてのジョブを再実行する] を選択します。
必要に応じて、再実行でランナー診断ログとステップデバッグログを有効にするには、 [デバッグログを有効にする] を選びます。

GitHub CLI の詳細については、「GitHub CLI について」を参照してください。

失敗したワークフロー実行を再実行するには、run rerun サブコマンドを使用します。 run-id を、再実行する失敗した実行の ID に置き換えます。 run-id を指定しない場合、GitHub CLI からは、最近の失敗した実行を選択するためのインタラクティブメニューが返されます。

gh run rerun RUN_ID

再実行でランナー診断ログとステップデバッグログを有効にするには、--debug フラグを使います。

gh run rerun RUN_ID --debug

ワークフロー実行の進行状況を表示するには、run watch サブコマンドを使用して、インタラクティブリストから実行を選択します。

gh run watch

ワークフローで失敗したジョブを再実行する

ワークフロー実行内のジョブが失敗した場合は、失敗したジョブのみを再実行できます。ワークフローで失敗したジョブを再実行すると、失敗したすべてのジョブとその依存ジョブに対して新しいワークフロー実行が開始されます。前のワークフロー実行で成功したジョブの出力はすべて、再実行に使用されます。最初の実行で作成されたすべての成果物は、再実行で使用できます。前の実行で渡されたすべての環境の保護ルールは、再実行で自動的に渡されます。

ご自分のエンタープライズで、リポジトリのメインページへ移動します。 1. リポジトリ名の下の [Actions] (アクション) をクリックします。 1. 左サイドバーで、表示するワークフローをクリックします。 1. ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。
ワークフローの右上隅にある [ ジョブの実行] ドロップダウンメニューから [Re-run failed jobs] (失敗したジョブの再実行) を選びます。
必要に応じて、再実行でランナー診断ログとステップデバッグログを有効にするには、 [デバッグログを有効にする] を選びます。

ワークフロー実行で失敗したジョブを再実行するには、--failed フラグと共に run rerun サブコマンドを使用します。 run-id を、失敗したジョブを再実行する実行の ID に置き換えます。 run-id を指定しない場合、GitHub CLI からは、最近の失敗した実行を選択するためのインタラクティブメニューが返されます。

gh run rerun RUN_ID --failed

再実行でランナー診断ログとステップデバッグログを有効にするには、--debug フラグを使います。

gh run rerun RUN_ID --failed --debug

ワークフローの特定のジョブを再実行する

ワークフローの特定のジョブを再実行すると、そのジョブとすべての依存ジョブに対して新しいワークフロー実行が開始されます。前のワークフローで実行されたその他のジョブの出力はすべて、再実行に使用されます。最初の実行で作成されたすべての成果物は、再実行で使用できます。前の実行で渡されたすべての環境の保護ルールは、再実行で自動的に渡されます。

ご自分のエンタープライズで、リポジトリのメインページへ移動します。 1. リポジトリ名の下の [Actions] (アクション) をクリックします。 1. 左サイドバーで、表示するワークフローをクリックします。 1. ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。
再実行するジョブの横にあるをクリックします。

または、ジョブをクリックしてログを表示します。ログで、をクリックします。
必要に応じて、再実行でランナー診断ログとステップデバッグログを有効にするには、 [デバッグログを有効にする] を選びます。

ワークフロー実行の特定のジョブを再実行するには、--job フラグと共に run rerun サブコマンドを使用します。 job-id を、再実行するジョブの ID に置き換えます。

gh run rerun --job JOB_ID

再実行でランナー診断ログとステップデバッグログを有効にするには、--debug フラグを使います。

gh run rerun --job JOB_ID --debug

再利用可能なワークフローでワークフローとジョブを再実行する

パブリックリポジトリの再利用可能なワークフローは、SHA、リリースタグ、またはブランチ名を使って参照できます。詳しくは、「ワークフローの再利用」を参照してください。

再利用可能なワークフローを使うワークフローを再実行し、参照が SHA ではない場合は、注意すべきいくつかの動作があります。

ワークフロー内のすべてのジョブを再実行すると、指定した参照の再利用可能なワークフローが使われます。ワークフロー内のすべてのジョブの再実行について詳しくは、「ワークフローとジョブの再実行」をご覧ください。
失敗したジョブまたはワークフロー内の特定のジョブを再実行すると、最初の試行と同じコミット SHA の再利用可能なワークフローが使われます。ワークフロー内の失敗したジョブの再実行について詳しくは、「ワークフローとジョブの再実行」をご覧ください。ワークフロー内の特定のジョブの再実行について詳しくは、「ワークフローとジョブの再実行」をご覧ください。

以前のワークフロー実行を確認する

ワークフローの実行に関する前回の試行の結果を表示できます。 API を使用して、以前のワークフロー実行を表示することもできます。詳しくは、「アクション」を参照してください。

ご自分のエンタープライズで、リポジトリのメインページへ移動します。 1. リポジトリ名の下の [Actions] (アクション) をクリックします。 1. 左サイドバーで、表示するワークフローをクリックします。 1. ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。
前回の実行試行は、 [最新] ドロップダウンメニューに表示されます。
エントリをクリックして結果を表示します。

ワークフローとジョブの再実行

この記事の内容