我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

管理工作流程运行

您可以查看工作流程中每个步骤的状态和结果,取消待定的工作流程,调试并重新运行失败的工作流程,搜索并下载日志,以及下载构件。

GitHub 操作 目前在有限公测阶段,可能会有变动。强烈建议在公测期间不要将此功能用于高价值工作流程和内容。

更多信息请参阅“关于 GitHub 操作”。

如果您启用了 GitHub 操作 并且对仓库具有写入权限,或者是拥有仓库的组织的成员,便可管理工作流程运行。

本文内容

关于工作流程管理

您可以从工作流程运行页面查看工作流程运行是在进行中,还是已完成。 如果运行正在进行中,您可以取消运行。 如果运行已完成,则可查看运行结果是成功、失败、已取消还是中性。 如果运行失败,您可以查看并搜索构建日志,来诊断失败原因并重新运行工作流程。 您也可以下载日志和构建构件。

标注的工作流程运行映像

GitHub 操作 使用 Checks API 来输出工作流程的状态、结果和日志。 GitHub 对同一事件触发的每个工作流程创建新检查套件。 检查套件包含检查工作流程中每项作业的运行,而每项作业包含步骤。 GitHub 操作 作为工作流程中的一个步骤运行。 有关检查 API 的更多信息,请参阅 GitHub 开发者文档 中的“检查”。

查看工作流程历史记录

您可以查看工作流程运行中的每项作业以及作业中的每个步骤。 更多信息请参阅“[关于

GitHub 操作 ](/articles/about-github-actions#key-concepts)”。

每项作业默认包含“设置作业”步骤和“完成作业”步骤,以及在工作流程文件中配置的操作。

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Actions(操作)

    主仓库导航中的 Actions(操作)选项卡

  3. 在左边栏中,单击要查看的工作流程。

    Workflow list in left sidebar

  4. 在“Workflow runs(工作流程运行)”下,单击要查看的运行的名称。

    Name of workflow run

  5. (可选)如果运行失败,要重新运行工作流程,请使用工作流程右上角的 Re-run checks(重新运行检查)下拉菜单,然后选择 Re-run all checks(重新运行所有检查)

    重新运行检查下拉菜单

取消工作流程运行

当您取消工作流程运行时,GitHub 会取消属于该工作流程的所有步骤。

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Actions(操作)

    主仓库导航中的 Actions(操作)选项卡

  3. 在左边栏中,单击要查看的工作流程。

    Workflow list in left sidebar

  4. 在“Workflow runs(工作流程运行)”下,单击要查看的运行的名称。

    Name of workflow run

  5. 在工作流程右上角单击 Cancel check suite(取消检查套件)

    取消检查套件按钮

查看日志以诊断故障

如果工作流程运行失败,您可以查看是哪个步骤导致了失败,然后审查失败步骤的创建日志进行故障排除。 您可以查看每个步骤运行的时长。 也可以将永久链接复制到日志文件中的特定行,与您的团队分享。

对于推送,GitHub 会将整个创建日志和构件存储 90 天,对于拉取请求则存储 30 天。 每当有人推送到拉取请求时,拉取请求的保存期就会重新开始计算。

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Actions(操作)

    主仓库导航中的 Actions(操作)选项卡

  3. 在左边栏中,单击要查看的工作流程。

    Workflow list in left sidebar

  4. 在“Workflow runs(工作流程运行)”下,单击要查看的运行的名称。

    Name of workflow run

  5. 在左边栏中,单击要查看的作业。

    List of jobs in left sidebar

  6. 要展开失败步骤的日志,请单击该步骤。

    失败的步骤名称

  7. (可选)要将某个链接复制到日志中的特定行,请将鼠标停留在该行上,然后单击

    复制链接的按钮

搜索日志

您可以搜索特定步骤的创建日志。 在搜索日志时,只有展开的步骤会包含在结果中。

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Actions(操作)

    主仓库导航中的 Actions(操作)选项卡

  3. 在左边栏中,单击要查看的工作流程。

    Workflow list in left sidebar

  4. 在“Workflow runs(工作流程运行)”下,单击要查看的运行的名称。

    Name of workflow run

  5. 在左边栏中,单击要查看的作业。

    List of jobs in left sidebar

  6. 要展开想包含在搜索中的每个步骤,请单击该步骤。

    步骤名称

  7. 在日志输出的右上角,在 Search logs(搜索日志)搜索框中输入搜索查询。

    搜索日志的搜索框

下载日志和构件

构件是创建并测试代码时所创建的文件。 例如,构件可能包含二进制或包文件、测试结果、屏幕截图或日志文件。 当运行完成时,这些文件将从运行工作流程的虚拟环境中删除,并且存档以供下载。

  1. 在 GitHub 上,导航到仓库的主页面。

  2. 在仓库名称下,单击 Actions(操作)

    主仓库导航中的 Actions(操作)选项卡

  3. 在左边栏中,单击要查看的工作流程。

    Workflow list in left sidebar

  4. 在“Workflow runs(工作流程运行)”下,单击要查看的运行的名称。

    Name of workflow run

  5. 要下载日志,请使用 Download logs(下载日志)下拉菜单,然后选择要下载的日志。

    下载日志下拉菜单

  6. 要下载构件,请使用 Artifacts(构件)下拉菜单,然后选择要下载的构件。

    构件下拉菜单

延伸阅读

问问别人

找不到要找的内容?

联系我们