重新运行工作流和作业

你可以在其最初运行后最多 30 天内重新运行工作流运行、工作流运行中的所有失败作业或工作流运行中的特定作业。

谁可以使用此功能？

对存储库具有写入权限的人员可以重新运行存储库中的工作流。

本文内容

关于重新运行工作流和作业

重新运行工作流或工作流中的作业会使用触发工作流运行的原始事件的相同 GITHUB_SHA（提交 SHA）和 GITHUB_REF（Git 引用）。工作流将使用最初触发工作流的执行者的权限，而不是发起重新运行的执行者的权限。您可以在初始运行后最多 30 天内重新运行工作流或工作流中的作业。一旦工作流中的作业日志超过其保留限制，您就无法重新运行这些作业。有关详细信息，请参阅“使用限制、计费和管理”。当您重新运行工作流或工作流中的作业时，您可以为重新运行启用调试日志记录。这将为重新运行启用运行程序诊断日志记录和步骤调试日志记录。有关调试日志记录的详细信息，请参阅“启用调试日志记录”。

重新运行工作流中的所有作业

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在存储库名称下方，单击 操作.

    Screenshot of the tabs for the "github/docs" repository. The "Actions" tab is highlighted with an orange outline.

  3. 在左侧边栏中，单击您要查看的工作流。

    Screenshot of the left sidebar of the "Actions" tab. A workflow, "CodeQL," is outlined in dark orange.

  4. 从工作流运行列表中，单击运行的名称以查看工作流运行摘要。

  5. 在工作流的右上角，重新运行作业。

    • 如果任何作业失败，请选择 重新运行作业 下拉菜单，然后单击重新运行所有作业。

    • 如果没有作业失败，请单击重新运行所有作业。

  6. （可选）要为重新运行启用运行程序诊断日志记录和步骤调试日志记录，请选择启用调试日志记录。

  7. 单击重新运行作业。

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

要重新运行失败的工作流运行，请使用 run rerun 子命令。用失败运行的 ID 替换 run-id，该运行是你想要重新运行的运行。如果你未指定 run-id，GitHub CLI 会返回一个交互式菜单，供你选择最近失败的运行。

gh run rerun RUN_ID

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

gh run rerun RUN_ID --debug

要查看工作流运行的进度，请使用 run watch 子命令，然后从交互式列表中选择运行。

gh run watch

在工作流中重新运行失败的任务

如果工作流运行中的任何任务失败，你可以仅重新运行失败的任务。当你重新运行工作流中的失败任务时，将为所有失败的任务及其依赖项启动新的工作流运行。前一个工作流运行中任何成功任务的任何输出都将用于重新运行。在初始运行中创建的任何工件都将在重新运行中可用。在前一次运行中通过的任何部署保护规则都将自动在重新运行中通过。

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在存储库名称下方，单击 操作.

    Screenshot of the tabs for the "github/docs" repository. The "Actions" tab is highlighted with an orange outline.

  3. 在左侧边栏中，单击您要查看的工作流。

    Screenshot of the left sidebar of the "Actions" tab. A workflow, "CodeQL," is outlined in dark orange.

  4. 从工作流运行列表中，单击运行的名称以查看工作流运行摘要。

  5. 在工作流的右上角，选择 重新运行任务 下拉菜单，然后单击重新运行失败的任务。

  6. （可选）要为重新运行启用运行程序诊断日志记录和步骤调试日志记录，请选择启用调试日志记录。

  7. 单击重新运行作业。

若要重新运行工作流运行中的失败作业，请使用带有 --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. 在 GitHub.com 上，导航到存储库的主页。

  2. 在存储库名称下方，单击 操作.

    Screenshot of the tabs for the "github/docs" repository. The "Actions" tab is highlighted with an orange outline.

  3. 在左侧边栏中，单击您要查看的工作流。

    Screenshot of the left sidebar of the "Actions" tab. A workflow, "CodeQL," is outlined in dark orange.

  4. 从工作流运行列表中，单击运行的名称以查看工作流运行摘要。

  5. 在左侧边栏的“作业”部分，在您要重新运行的作业旁边，单击 .

  6. （可选）要为重新运行启用运行程序诊断日志记录和步骤调试日志记录，请选择启用调试日志记录。

  7. 单击重新运行作业。

若要重新运行工作流运行中的特定作业，请使用带有 --job 标志的 run rerun 子命令。将 job-id 替换为要重新运行的作业的 ID。

gh run rerun --job JOB_ID

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

gh run rerun --job JOB_ID --debug

使用可重用工作流重新运行工作流和作业

可以使用 SHA、发布标签或分支名称引用公共存储库中的可重用工作流。有关详细信息，请参阅“重用工作流”。

当您重新运行使用可重用工作流的工作流且引用不是 SHA 时，需要注意一些行为

  • 重新运行工作流中的所有作业将使用指定引用中的可重用工作流。有关重新运行工作流中所有作业的详细信息，请参阅“重新运行工作流和作业”。
  • 重新运行工作流中的失败作业或特定作业将使用第一次尝试的相同提交 SHA 中的可重用工作流。有关重新运行工作流中失败作业的详细信息，请参阅“重新运行工作流和作业”。有关重新运行工作流中特定作业的详细信息，请参阅“重新运行工作流和作业”。

查看以前的运行工作流

您可以查看您以前尝试运行工作流的结果。您还可以使用 API 查看以前的运行工作流。有关详细信息，请参阅“工作流运行的 REST API 端点”。

  1. 在 GitHub.com 上，导航到存储库的主页。

  2. 在存储库名称下方，单击 操作.

    Screenshot of the tabs for the "github/docs" repository. The "Actions" tab is highlighted with an orange outline.

  3. 在左侧边栏中，单击您要查看的工作流。

    Screenshot of the left sidebar of the "Actions" tab. A workflow, "CodeQL," is outlined in dark orange.

  4. 从工作流运行列表中，单击运行的名称以查看工作流运行摘要。

  5. 在运行名称的右侧，选择最新下拉菜单，然后单击以前的运行尝试。