跳至主要内容

限制 Codespaces 的保留期限

您可以为您的组织拥有的任何 Codespaces 设置最长保留期限。

谁可以使用此功能?

要管理组织 Codespaces 的保留限制,您必须是该组织的所有者。

GitHub Team 和 GitHub Enterprise 计划的组织可以为成员和协作者使用 GitHub Codespaces 付费。然后,这些组织可以访问设置和策略来管理组织付费的 Codespaces。有关更多信息,请参阅“选择谁拥有和支付组织中的 Codespaces”和“GitHub 的计划”。

概述

GitHub Codespaces会在停止后且保持不活动状态一段时间后自动删除。每个Codespace的保留期限在创建时设置,并且不会更改。默认保留期限为30天。

GitHub用户可以为其创建的Codespaces设置少于30天的个人保留期限。更多信息,请参见“配置Codespaces的自动删除”。

作为组织所有者,您可能希望配置对组织拥有的代码库创建的Codespaces的最大保留期限的限制。这可以帮助您限制与已停止且未使用直到自动删除的Codespaces相关的存储成本。有关存储费用的更多信息,请参见“GitHub Codespaces计费信息”。您可以为组织拥有的所有代码库或特定代码库设置最大保留期限。

注意

为代码库设置最大保留策略可防止用户将Codespace免于自动删除。“保留Codespace”选项将不可用于为该代码库创建的Codespaces。更多信息,请参见“配置Codespaces的自动删除”。

设置组织范围和代码库特定策略

创建策略时,您可以选择它应用于组织中的所有代码库,还是仅应用于指定的代码库。如果您创建了一个具有Codespace保留限制的组织范围策略,则针对特定代码库的任何策略中的保留限制应短于为整个组织配置的限制,否则它们将无效。将应用最短的保留期限——在组织范围策略中、针对指定代码库的策略中或某人的个人设置中的默认保留期限。

如果您添加具有保留限制的组织范围策略,则应将保留期限设置为可接受的最长时间段。然后,您可以添加单独的策略,为组织中的特定代码库将最大保留时间设置为较短的时间段。

注意

Codespaces策略仅适用于您的组织付费的Codespaces。如果有人自行承担费用为组织中的代码库创建Codespace,则该Codespace将不受这些策略约束。更多信息,请参见“选择谁拥有和支付组织中的Codespaces”。

添加策略以设置最大Codespace保留期限

  1. 在GitHub的右上角,选择您的个人资料照片,然后单击 您的组织.

  2. 在组织旁边,单击**设置**。

  3. 在侧边栏的“代码、规划和自动化”部分,选择** Codespaces**,然后单击**策略**。

  4. 在“Codespaces策略”页面上,单击**创建策略**。

  5. 输入新策略的名称。

  6. 单击**添加约束**并选择**保留期限**。

  7. 单击以编辑约束。

  8. 输入Codespaces在自动删除前可以保持停止状态的最大天数,然后单击**保存**。

    Screenshot of a dropdown with a field labeled "Maximum value" set to 8 days. Below this are "Cancel" and "Save" buttons.

    注意

    • 在此上下文中,一天是指从Codespace停止时间的当天开始的24小时。
    • 有效范围是0-30天。
    • 将期限设置为0将导致Codespaces在停止时或由于不活动而超时时立即删除。
  9. 默认情况下,策略设置为应用于所有代码库,如果您希望它仅应用于组织中的一些代码库,请单击**所有代码库**,然后在下拉菜单中单击**选定代码库**。

    Screenshot of the repository selection dropdown, showing the options "All repositories" and "Selected repositories."

    注意

    如果您正在向已包含“每个用户的最大Codespaces”约束的现有策略添加约束,则您将无法将该策略应用于选定的代码库。这是因为“每个用户的最大Codespaces”约束始终应用于组织中的所有代码库。

    已选择**选定代码库**

    1. 单击.

      Screenshot of the settings icon (a gear symbol) to the left of a button labeled "Selected repositories."

    2. 选择您希望此策略应用到的代码库。

    3. 在代码库列表底部,单击**选择代码库**。

      Screenshot of a list of repositories, each with a checkbox. Three repositories are selected.

  10. 如果您想向策略添加另一个约束,请单击**添加约束**并选择另一个约束。有关其他约束的信息,请参见

  11. 完成向策略添加约束后,单击**保存**。

该策略将应用于所有向您的组织计费的新Codespaces。保留期限约束仅在创建Codespace时应用。

编辑策略

您可以编辑现有策略。例如,您可能希望向策略添加或从中删除约束。

保留期限约束仅在创建Codespaces时应用。编辑策略不会对现有Codespaces产生任何影响。

  1. 显示“Codespaces策略”页面。更多信息,请参见“添加策略以设置最大Codespace保留期限”。
  2. 单击要编辑的策略的名称。
  3. 在“保留期限”约束旁边,单击.
  4. 进行必要的更改,然后单击**保存**。

删除策略

您可以随时删除策略。删除策略不会对现有Codespaces产生任何影响。

  1. 显示“Codespaces策略”页面。更多信息,请参见“添加策略以设置最大Codespace保留期限”。

  2. 单击要删除的策略右侧的删除按钮。

  3. 单击要删除的策略右侧。

    Screenshot of a policy with the delete button (a trash can icon) highlighted with a dark orange outline.