下载工作流工件

您可以在工作流工件自动过期之前下载已存档的工件。

谁可以使用此功能？

登录 GitHub 并具有存储库读取权限的人员可以下载工作流工件。

默认情况下，GitHub 会存储 90 天的构建日志和工件，您可以根据存储库类型自定义此保留期。有关更多信息，请参阅“管理存储库的 GitHub Actions 设置”。

执行这些步骤需要存储库的读取权限。

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

  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. 在“工件”部分，点击您要下载的工件。

    Screenshot of the "Artifacts" section of a workflow run. The name of an artifact generated by the run, "artifact," is highlighted with a dark orange outline.

要了解有关 GitHub CLI 的更多信息，请参阅“关于 GitHub CLI”。

GitHub CLI 会根据工件名称将每个工件下载到单独的目录中。如果仅指定一个工件，则将其提取到当前目录中。

要下载工作流运行生成的所有工件，请使用run download子命令。将run-id替换为要从中下载工件的运行的 ID。如果您未指定run-id，则 GitHub CLI 会返回一个交互式菜单，供您选择最近的运行。

gh run download RUN_ID

要下载运行中的特定工件，请使用run download子命令。将run-id替换为要从中下载工件的运行的 ID。将artifact-name替换为要下载的工件的名称。

gh run download RUN_ID -n ARTIFACT_NAME

您可以指定多个工件。

gh run download RUN_ID> -n ARTIFACT_NAME-1 -n ARTIFACT_NAME-2

要下载存储库中所有运行中的特定工件，请使用run download子命令。

gh run download -n ARTIFACT_NAME-1 ARTIFACT_NAME-2