Skip to main content
ドキュメントへの更新が頻繁に発行されており、このページの翻訳はまだ行われている場合があります。 最新の情報については、「英語のドキュメント」を参照してください。
現在、GitHub AE は限定的リリースです。

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

ワークフローの実行、ワークフローの実行で失敗したすべてのジョブ、またはワークフローの実行内の特定のジョブを、最初の実行から最大 30 日後まで再実行できます。

この機能を使用できるユーザー

People with write permissions to a repository can re-run workflows in the repository.

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

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

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

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

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

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

    [チェックの再実行] ドロップダウン メニュー 1. ワークフローの右上隅にある [ジョブの再実行] ドロップダウン メニューを使用して、 [すべてのジョブを再実行する] を選択します。

    [チェックの再実行] ドロップダウン メニュー

  2. 必要に応じて、再実行でランナー診断ログとステップ デバッグ ログを有効にするには、 [デバッグ ログを有効にする] を選びます。 デバッグ ログを有効にする

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

    ワークフローの実行の名前

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

    [チェックの再実行] ドロップダウン メニュー

  3. 必要に応じて、再実行でランナー診断ログとステップ デバッグ ログを有効にするには、 [デバッグ ログを有効にする] を選びます。 デバッグ ログを有効にする

ワークフロー実行で失敗したジョブを再実行するには、--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. ご自分のエンタープライズ で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [Actions] (アクション) をクリックします。 メインのリポジトリ ナビゲーション内の [Actions](アクション) タブ 1. 左サイドバーで、表示するワークフローをクリックします。 左サイドバーのワークフロー リスト 1. ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。

    ワークフローの実行の名前

  2. 再実行するジョブの横にある をクリックします。 選択したジョブの再実行

    または、ジョブをクリックしてログを表示します。 ログで、 をクリックします。 選択したジョブの再実行

  3. 必要に応じて、再実行でランナー診断ログとステップ デバッグ ログを有効にするには、 [デバッグ ログを有効にする] を選びます。 デバッグ ログを有効にする

ワークフロー実行の特定のジョブを再実行するには、--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. ご自分のエンタープライズ で、リポジトリのメイン ページへ移動します。 1. リポジトリ名の下の [Actions] (アクション) をクリックします。 メインのリポジトリ ナビゲーション内の [Actions](アクション) タブ 1. 左サイドバーで、表示するワークフローをクリックします。 左サイドバーのワークフロー リスト 1. ワークフロー実行の一覧で実行の名前をクリックすると、ワークフロー実行の概要が表示されます。

    ワークフローの実行の名前

  2. 前回の実行試行は、 [最新] ドロップダウン メニューに表示されます。 前回の実行試行

  3. エントリをクリックして結果を表示します。