Re-running workflows and jobs

注意

GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。

About re-running workflows and jobs

Re-running a workflow or jobs in a workflow uses the same GITHUB_SHA (commit SHA) and GITHUB_REF (Git ref) of the original event that triggered the workflow run. The workflow will use the privileges of the actor who initially triggered the workflow, not the privileges of the actor who initiated the re-run. You can re-run a workflow or jobs in a workflow for up to 30 days after the initial run. You cannot re-run jobs in a workflow once its logs have passed their retention limits. For more information, see Usage limits, billing, and administration. When you re-run a workflow or jobs in a workflow, you can enable debug logging for the re-run. This will enable runner diagnostic logging and step debug logging for the re-run. For more information about debug logging, see Enabling debug logging

Re-running all the jobs in a workflow

在 GitHub 上，导航到存储库的主页面。
在存储库名称下，单击 “操作”。
在左侧边栏中，单击您想要查看的工作流程。
在工作流运行列表中，单击运行的名称以查看工作流运行摘要。
In the upper-right corner of the workflow, re-run jobs.
- If any jobs failed, select the Re-run jobs dropdown menu and click Re-run all jobs.
- If no jobs failed, click Re-run all jobs.
（可选）若要为重新运行启用运行程序诊断日志记录和步骤调试日志记录，请选择“启用调试日志记录”。
单击“重新运行作业****”。

注意

若要详细了解 GitHub CLI，请参阅“关于 GitHub CLI”。

To re-run a failed workflow run, use the run rerun subcommand. Replace run-id with the ID of the failed run that you want to re-run. If you don't specify a run-id, GitHub CLI returns an interactive menu for you to choose a recent failed run.

gh run rerun RUN_ID

若要为重新运行启用运行器诊断日志记录和单步调试日志记录，请使用 --debug 标志。

gh run rerun RUN_ID --debug

To view the progress of the workflow run, use the run watch subcommand and select the run from the interactive list.

gh run watch

Re-running failed jobs in a workflow

If any jobs in a workflow run failed, you can re-run just the jobs that failed. When you re-run failed jobs in a workflow, a new workflow run will start for all failed jobs and their dependents. Any outputs for any successful jobs in the previous workflow run will be used for the re-run. Any artifacts that were created in the initial run will be available in the re-run. Any deployment protection rules that passed in the previous run will automatically pass in the re-run.

在 GitHub 上，导航到存储库的主页面。
在存储库名称下，单击 “操作”。
在左侧边栏中，单击您想要查看的工作流程。
在工作流运行列表中，单击运行的名称以查看工作流运行摘要。
In the upper-right corner of the workflow, select the Re-run jobs dropdown menu, and click Re-run failed jobs.
（可选）若要为重新运行启用运行程序诊断日志记录和步骤调试日志记录，请选择“启用调试日志记录”。
单击“重新运行作业****”。

To re-run failed jobs in a workflow run, use the run rerun subcommand with the --failed flag. Replace run-id with the ID of the run for which you want to re-run failed jobs. If you don't specify a run-id, GitHub CLI returns an interactive menu for you to choose a recent failed run.

gh run rerun RUN_ID --failed

若要为重新运行启用运行器诊断日志记录和单步调试日志记录，请使用 --debug 标志。

gh run rerun RUN_ID --failed --debug

Re-running a specific job in a workflow

When you re-run a specific job in a workflow, a new workflow run will start for the job and any dependents. Any outputs for any other jobs in the previous workflow run will be used for the re-run. Any artifacts that were created in the initial run will be available in the re-run. Any deployment protection rules that passed in the previous run will automatically pass in the re-run.

在 GitHub 上，导航到存储库的主页面。
在存储库名称下，单击 “操作”。
在左侧边栏中，单击您想要查看的工作流程。
在工作流运行列表中，单击运行的名称以查看工作流运行摘要。
Under the "Jobs" section of the left sidebar, next to the job that you want to re-run, click .
（可选）若要为重新运行启用运行程序诊断日志记录和步骤调试日志记录，请选择“启用调试日志记录”。
单击“重新运行作业****”。

To re-run a specific job in a workflow run, use the run rerun subcommand with the --job flag. Replace job-id with the ID of the job that you want to re-run.

gh run rerun --job JOB_ID

若要为重新运行启用运行器诊断日志记录和单步调试日志记录，请使用 --debug 标志。

gh run rerun --job JOB_ID --debug