跳到主要内容

限制空闲超时时间

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

谁可以使用此功能?

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

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

概述

默认情况下,Codespaces 在 30 分钟不活动后超时。当 Codespace 超时时,它将被停止,并且将不再产生计算使用费。

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

作为组织所有者,您可能希望配置对为您的组织拥有的仓库创建的 Codespaces 的最大空闲超时时间的限制。这可以帮助您限制与长时间不活动后超时 Codespaces 相关的成本。您可以为组织拥有的所有仓库的 Codespaces 设置最大超时时间,也可以为特定仓库的 Codespaces 设置最大超时时间。

注意

最大空闲超时限制仅适用于您的组织拥有的 Codespaces。

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

不活动定义

在 Codespaces 空闲超时上下文中,非活动状态定义为缺乏表明用户存在的活动。与 Codespace 的个人互动,例如打字或使用鼠标,都会重置空闲超时时间段。终端活动(输入或输出)也会重置空闲超时时间段。例如,如果您从 Codespace 的某个端口发布 Web 应用,并且页面请求在 Codespace 上的终端中生成输出,则每次终端输出发生时,超时都会被重置。但是,如果您共享端口,然后不与 Codespace 交互,并且没有生成终端输出,则 Codespace 将在配置的时间段后超时。

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

如果某人在个人设置中将默认空闲超时设置为 90 分钟,然后启动一个具有 60 分钟最大空闲超时约束的代码库的 Codespace,则 Codespace 将在 60 分钟的非活动状态后超时。Codespace 创建完成后,将显示一条解释此情况的消息。

此 Codespace 的空闲超时设置为 60 分钟,以符合您组织的策略。

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

创建策略时,您可以选择将其应用于组织中的所有代码库,还是仅应用于指定的代码库。如果您创建了一个具有超时约束的组织范围策略,则针对特定代码库的任何策略中的超时约束必须符合为整个组织配置的限制。将应用最短的超时时间段——在组织范围策略中、针对特定代码库的策略中或在某人的个人设置中。

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

注意

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

添加策略以设置最大空闲超时时间段

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

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

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

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

  5. 输入新策略的名称。

  6. 单击**添加约束**并选择**最大空闲超时**。

  7. 单击以编辑约束。

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

    Screenshot of a dropdown with a field labeled "Maximum value" set to 60 minutes. To the right of the field is a "Save" button.

  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。超时约束也将在下次启动现有 Codespaces 时应用。

编辑策略

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

  1. 显示“Codespaces 策略”页面。有关更多信息,请参阅“添加策略以设置最大空闲超时时间段”。
  2. 单击要编辑的策略的名称。
  3. 在“最大空闲超时”约束旁边,单击.
  4. 进行必要的更改,然后单击**保存**。

删除策略

  1. 显示“Codespaces 策略”页面。有关更多信息,请参阅“添加策略以设置最大空闲超时时间段”。

  2. 单击在您想要删除的策略的右侧。

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