Skip to main content

限制空闲超时期限

你可以为组织拥有的任何 codespace 设置最大超时时间。

Who can use this feature

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

概述

默认情况下,codespace 会在处于非活动状态 30 分钟后超时。 当 codespace 超时时,它会停止,并且不会再产生计算使用费用。

GitHub 用户的个人设置允许他们为创建的 codespace 定义自己的超时期限。 这可能比默认的 30 分钟期限长。 有关详细信息,请参阅“设置 GitHub Codespaces 的超时时间”。

作为组织所有者,你可能希望为针对组织拥有的存储库创建的 codespace 的最大空闲超时时间配置约束。 这有助于限制与长时间处于非活动状态后超时的 codespace 相关的成本。 你可以为组织拥有的所有存储库的 codespace 或特定存储库的 codespace 设置最大超时。

注意:最大空闲超时约束仅应用于组织拥有的 codespace。

有关 GitHub Codespaces 计算使用量的定价的详细信息,请参阅“关于 GitHub Codespaces 的计费”。

设置最大空闲超时约束时的行为

如果某人在其个人设置中将默认空闲超时设置为 90 分钟,然后为具有最大空闲超时约束的存储库启动 codespace 60 分钟,则该 codespace 将在处于非活动状态 60 分钟后超时。 codespace 创建完成后,将显示一条消息,指出这一点:

根据组织的策略,此 codespace 的空闲超时设置为 60 分钟。

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

创建策略时,你可以选择是将其应用于组织中的所有存储库,还是仅应用于指定的存储库。 如果创建具有超时约束的组织范围的策略,则针对特定存储库的任何策略中的超时约束必须属于为整个组织配置的限制。 在组织范围的策略、针对指定存储库的策略或某人的个人设置中的策略中,将应用最短的超时期限。

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

注意:Codespace 策略仅适用于组织将为其计费的 codespace。 如果个人用户为组织中的存储库创建 codespace,并且不会对组织进行计费,则 codespace 不受这些策略的约束。 有关如何选择谁可以创建对组织进行计费的 codespace 的信息,请参阅“为组织启用 GitHub Codespaces”。

添加策略以设置最大空闲超时期限

  1. 在 GitHub.com 的右上角,单击你的个人资料照片,然后单击“你的组织”。 贵组织在配置文件菜单中 2. 在组织旁边,单击“设置”。 设置按钮 1. 在边栏的“代码、规划和自动化”部分中,选择“ Codespaces”,然后单击“策略” 。

  2. 在“codespace 策略”页上,单击“创建策略”。

  3. 输入新策略的名称。

  4. 单击“添加约束”,然后选择“最大空闲超时”。

    “添加约束”下拉菜单的屏幕截图

  5. 单击 编辑约束。

    用于编辑约束的铅笔图标的屏幕截图

  6. 输入 codespace 的最大分钟数可以在超时之前保持非活动状态,然后单击“保存”。

    设置最大超时(以分钟为单位)的屏幕截图

  7. 在“Change policy target(更改策略目标)”区域中,单击下拉按钮。

  8. 选择“所有存储库”或“所选存储库”以确定此策略将应用到的存储库 。

  9. 如果选择“选定的存储库”:

    1. 单击

      编辑策略的设置

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

    3. 在存储库列表的底部,单击“选择存储库”。

      为此策略选择存储库

  10. 如果要向策略添加另一个约束,请单击“添加约束”并选择另一个约束。 有关其他约束的信息,请参阅:

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

策略将应用于对组织计费的所有新 codespace。 下次启动现有 codespace 时,超时约束也会对其应用。

编辑策略

可以编辑现有策略。 例如,你可能想要在策略中添加或移除约束。

  1. 显示“Codespace policies(代码空间策略)”页。 有关详细信息,请参阅“添加策略以设置最大空闲超时期限”。
  2. 单击要编辑的策略的名称。
  3. 单击“最大空闲超时”约束旁边的铅笔图标 ()。
  4. 执行所需更改,然后单击“保存”。

删除策略

  1. 显示“Codespace policies(代码空间策略)”页。 有关详细信息,请参阅“添加策略以设置最大空闲超时期限”。

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

    策略的“删除”按钮的屏幕截图