Removing workflow artifacts

You can reclaim used GitHub Actions storage by deleting artifacts before they expire on GitHub.

本文内容

注意

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

Deleting an artifact

警告

Once you delete an artifact, it cannot be restored.

执行这些步骤需要对仓库的写入访问权限。

默认情况下，GitHub 存储 90 天内的生成日志和项目，此保持期可自定义。 有关详细信息，请参阅“Usage limits, billing, and administration”。

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

  2. 在存储库名称下，单击 “操作”。

    “github/docs”存储库的选项卡的屏幕截图。 “操作”选项卡以橙色边框突出显示。

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

    “操作”选项卡的左侧边栏的屏幕截图。工作流“CodeQL”以深橙色标出。

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

  5. Under Artifacts, click next to the artifact you want to remove.

    Screenshot showing artifacts created during a workflow run. A trash can icon, used to remove an artifact, is outlined in dark orange.

Setting the retention period for an artifact

Retention periods for artifacts and logs can be configured at the repository, organization, and enterprise level. For more information, see Usage limits, billing, and administration.

You can also define a custom retention period for individual artifacts using the actions/upload-artifact action in a workflow. For more information, see Storing and sharing data from a workflow.

Finding the expiration date of an artifact

You can use the API to confirm the date that an artifact is scheduled to be deleted. For more information, see the expires_at value returned by the REST API. For more information, see GitHub Actions 构件的 REST API 终结点.

已删除的工作流运行中的工件

删除某个工作流运行时，也会从存储中删除与该运行关联的所有工件。 可以使用 GitHub Actions UI、REST API 或使用 GitHub CLI 删除工作流运行，请参阅“Deleting a workflow run”、删除工作流运行或 gh run delete。