Skip to main content

设置 GitHub Codespaces 超时期限

可以在个人设置页面中设置 GitHub Codespaces 的默认超时。

关于空闲超时

代码空间将在一段时间不活动后停止运行。 默认情况下,此时间段为 30 分钟,但你可以在 GitHub 上的个人设置中指定更长或更短的默认超时期限。 更新的设置将应用于你创建的任何新代码空间。 还可以在使用 GitHub CLI 创建 codespace 时指定超时。

警告

在 codespace 处于活动状态期间对 codespaces 计算用量计费。 如果未使用 codespace,但它仍在运行,并且尚未超时,则无论是否正在使用 codespace,你都需按 codespace 处于活动状态的总时间付费。 有关详细信息,请参阅“GitHub Codespaces 计费”。

定义的非活动

在 Codespaces 空闲超时的上下文中,非活动定义为用户状态缺少活动指示性。 与 Codespaces 进行个人交互(例如输入或使用鼠标)会重置空闲超时期限。 此外,终端活动(输入或输出)也会重置空闲超时期限。 例如,如果从 codespace 在端口上发布一个 Web 应用且页面请求在 codespace 上的终端中生成输出,则每当发生终端输出时都会重置超时。 但是,如果共享端口,然后不与 codespace 交互并且不生成终端输出,则 codespace 将在配置的时间段后超时。

组织拥有的存储库的超时时段

组织可以为从其部分或所有存储库创建的 codespace 设置最大空闲超时策略。 如果组织策略设置的最大超时时间少于你设置的默认超时时间,将使用组织的超时时间而不是你设置的超时时间。 你将在 codespace 创建后收到此通知。 有关详细信息,请参阅“限制空闲超时期限”。

设置默认超时期限

  1. 在 GitHub 任意页面的右上角,单击你的个人资料照片,然后单击“ Settings”。1. 在边栏的“Code, planning, and automation”部分中,单击 “Codespaces”

  2. 在“默认空闲超时”下,输入所需时间,然后单击“保存”。 时间必须在 5 分钟到 240 分钟(4 小时)之间。

    Codespaces 设置的“默认空闲超时”部分的屏幕截图,其中输入了“90 分钟”。

设置 codespace 的超时期限

注意

若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。

若要设置创建代码空间时的超时期限,请将 idle-timeout 参数与 codespace create 子命令一起使用。 指定以分钟为单位的时间,后跟 m。 时间必须在 5 分钟到 240 分钟(4 小时)之间。

gh codespace create --idle-timeout 90m

如果在创建代码空间时未指定超时期限,则将使用默认超时期限。 有关设置默认超时期限的信息,请单击此页面上的“Web browser(Web 浏览器)”选项卡。 您当前无法通过 GitHub CLI 指定默认超时期限。

设置超时期限

可以通过 Web 浏览器在 GitHub 上设置默认超时期限。 或者,如果使用 GitHub CLI 创建 codespace,则可以为该特定 codespace 设置超时期限。 有关详细信息,请单击上面相应的选项卡。

延伸阅读

  •         [AUTOTITLE](/codespaces/customizing-your-codespace)
    
  •         [AUTOTITLE](/codespaces/managing-your-codespaces)