Skip to main content

限制代码空间的保留期

您可以为组织拥有的任何代码空间设置最长保留期。

To manage retention constraints for an organization's codespaces, you must be an owner of the organization.

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

概览

Codespaces 在停止后会自动删除,并在定义的天数内保持非活动状态。 每个代码空间的保留期是在创建代码空间时设置的,不会更改。

有权访问 GitHub Codespaces 的每个人都可以为他们创建的代码空间配置保留期。 此默认保留期的初始设置为 30 天。 单个用户可以将此时间段设置在 0-30 天的范围内。 更多信息请参阅“配置代码空间的自动删除”。

作为组织所有者,您可能希望为为组织拥有的存储库创建的代码空间的最长保留期配置限制。 这可以帮助您限制与代码空间相关的存储成本,这些代码空间已停止,然后一直处于未使用状态,直到它们被自动删除。 有关存储费用的详细信息,请参阅关于 GitHub Codespaces 的计费”。 您可以为组织拥有的所有仓库或特定仓库设置最长保留期。

设置组织范围和存储库特定的策略

创建策略时,您可以选择是将其应用于组织中的所有存储库,还是仅应用于指定的存储库。 如果创建具有代码空间保留约束的组织范围的策略,则针对特定存储库的任何策略中的保留约束应短于为整个组织配置的限制,否则它们将不起作用。 应用组织范围策略、针对指定存储库的策略或某人个人设置的默认保留期中最短的保留期。

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

添加策略以设置最大代码空间保留期

  1. 在 GitHub.com 的右上角,单击您的头像,然后单击 Your organizations(您的组织)个人资料菜单中的组织

  2. 在组织旁边,单击 Settings(设置)设置按钮

  3. 在边栏的“Code, planning, and automation(代码、规划和自动化)”部分中,选择 Codespaces,然后单击 Policies(策略)

  4. 在“Codespace policies(代码空间策略)”页面上,单击 Create Policy(创建策略)

  5. 输入新策略的名称。

  6. 单击 Add constraint(添加约束) ,然后选择 Retention period(保留期)

    为保留期添加约束

  7. 单击 编辑约束。

    编辑超时约束

  8. 输入代码空间在被自动删除之前可以保持停止状态的最大天数,然后单击 Save(保存)

    设置保留期(天)

    注意

    • 在这种情况下,一天是 24 小时的时间,从代码停止的那一刻开始。
    • 有效范围为 0-30 天。
    • 将周期设置为 0 将导致代码空间在停止时立即删除,或者由于不活动而超时被删除。
  9. 在“Change policy target(更改策略目标)”区域中,单击下拉按钮。

  10. 选择 All repositories(所有存储库)Selected repositories(选定的存储库),以确定此策略将应用于哪些存储库。

  11. 如果选择了 Selected repositories(所选仓库)

    1. 单击

      编辑策略的设置

    2. 选择要应用此策略的存储库。

    3. 在存储库列表的底部,单击 Select repositories(选择存储库)

      为此策略选择存储库

  12. 如果要向策略添加其他约束,请单击 Add constraint(添加约束) ,然后选择另一个约束。 有关其他约束的信息,请参阅“限制对计算机类型的访问”、“限制转发端口的可见性”和“限制空闲超时期”。

  13. 向策略添加完约束后,单击 Save(保存)

该策略将应用于创建的所有新代码空间。

编辑策略

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

保留期约束仅在创建代码空间时应用于代码空间。 编辑策略对现有代码空间没有影响。

  1. 显示“Codespace policies(代码空间策略)”页。 更多信息请参阅“添加策略以设置最大代码空间保留期”。
  2. 单击要编辑的策略的名称。
  3. 进行所需的更改,然后单击 Save(保存)

删除策略

您可以随时删除策略。 删除策略对现有代码空间没有影响。

  1. 显示“Codespace policies(代码空间策略)”页。 更多信息请参阅“添加策略以设置最大代码空间保留期”。

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

    策略的删除按钮