Skip to main content

配置代码空间的自动删除

未使用的代码空间将自动删除。 您可以选择停止的代码空间保留多长时间,最多保留 30 天。

GitHub Codespaces 可用于使用 GitHub Team 或 GitHub Enterprise Cloud 的组织。 更多信息请参阅“GitHub 的产品”。

默认情况下,Codespaces 在停止后会自动删除,并保持非活动状态 30 天。

但是,由于 Codespaces 会产生存储费用,因此您可能希望通过在个人设置中更改 GitHub Codespaces 的默认保留期来缩短保留期。 有关存储费用的详细信息,请参阅关于 GitHub Codespaces 的计费”。

注意:无论您是否设置了个人代码空间保留期,最好养成删除不再需要的代码空间的习惯。 更多信息请参阅“删除代码空间”。

无论代码空间是否包含未推送的更改,都会发生自动删除。 要防止自动删除代码空间,只需再次打开代码空间即可。 每次连接到代码空间时都会重置保留期,并在代码空间停止时重新启动保留倒计时。

如果存储库属于某个组织,则组织管理员可能已为整个组织设置了保留期。 如果此保留期小于个人设置中的默认保留期,则组织保留期将应用于您为此存储库创建的代码空间。 更多信息请参阅“限制代码空间的保留期”。

每个代码空间都有自己的保留期。 因此,您可能具有不同租用期的代码空间。 例如,如果:

  • 您创建了一个代码空间,更改了默认保留期,然后创建了另一个代码空间。
  • 您使用 GitHub CLI 创建了代码空间,并指定了不同的保留期。
  • 您从组织拥有的存储库创建了代码空间,该存储库具有为组织配置的保留期。

:保留期以天为单位指定。 一天表示一个 24 小时的时间段,从一天中停止代码空间的时间开始。

为代码空间设置默认保留期

  1. 在任何页面的右上角,单击您的个人资料照片,然后单击 Settings(设置)

    用户栏中的 Settings 图标

  2. 在边栏的“Code, planning, and automation(代码、规划和自动化)”部分中,点击 Codespaces

  3. 在“Default retention period(默认保留期)”下,输入代码空间停止后默认希望保留的天数。

    选择保留期

    您可以将默认保留期设置为介于 030 天之间。

    警告:将期限设置为 0 将导致在停止代码空间时立即删除代码空间,或者由于不活动超时而删除。 有关详细信息,请参阅“设置 GitHub Codespaces 的超时期”。

  4. 单击 Save(保存)

使用 GitHub CLI 创建代码空间时,可以覆盖此默认值。 如果在组织中创建了指定较短保留期的代码空间,则组织级值将覆盖您的个人设置。

如果您将保留期设置为一天以上,则会在删除前一天收到电子邮件通知。

检查自动删除之前的剩余时间

您可以检查代码空间是否即将被自动删除。

当非活动代码空间接近其保留期结束时,这将在 https://github.com/codespaces 上 GitHub 的代码空间列表中指示。

GitHub 上的代码空间列表中的删除前消息

设置代码空间的保留期

若要在创建代码空间时设置代码空间保留期,请将 --retention-period 标志与 codespace create 子命令一起使用。 以天为单位指定期限。 期限必须介于 0 到 30 天之间。

gh codespace create --retention-period DAYS

如果在创建代码空间时未指定保留期,则将使用默认保留期或组织保留期,具体取决于哪个保留期更短。 有关设置默认保留期的信息,请单击此页面上的“Web browser(Web 浏览器)”选项卡。

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

设置保留期

您可以在 Web 浏览器的 GitHub.com 上设置默认保留期。 或者,如果使用 GitHub CLI 创建代码空间,则可以为该特定代码空间设置保留期。 有关详细信息,请单击上面的相应选项卡。

检查代码空间是否很快将自动删除

您可以在 Visual Studio Code 桌面应用程序中检查代码空间是否即将被自动删除。

  1. 在 VS 代码 中,从左侧边栏单击 Remote Explorer 图标。 Visual Studio Code 中的 Remote Explorer 图标

  2. 如果尚未选择远程资源管理器,请从远程资源管理器右上角的下拉菜单中选择 GitHub Codespaces

  3. 在“GITHUB CODESPACES”下,将鼠标指针放在您感兴趣的代码空间上。 将显示一个弹出框,其中显示有关代码空间的信息。

    如果代码空间即将结束其保留期,则会包含一行,告诉您何时删除代码空间。

    显示删除前时间的代码空间信息