Skip to main content

为代码空间计算机设置最低规范

你可以避免资源不足的计算机类型用于存储库的 GitHub Codespaces。

谁可以使用此功能?

People with write permissions to a repository can create or edit the codespace configuration.

概述

创建的每个 codespace 都托管在单独的虚拟机上。 从存储库创建 codespace 时,通常可以从不同类型的虚拟机中进行选择。 每个计算机类型都有不同的资源(处理器内核、内存、存储),默认情况下,使用资源最少的计算机类型。 有关详细信息,请参阅“更改代码空间的计算机类型”。

如果项目需要一定程度的计算能力,则可以配置 GitHub Codespaces 以便默认情况下只能使用或由用户选择满足这些要求的计算机类型。 可以在 devcontainer.json 文件中进行此配置。

未发布的 codespace(使用模板创建且未链接到 GitHub 上存储库的 codespace)始终在具有相同规范的虚拟机上运行。 无法更改未发布的 codespace 的计算机类型。

Important

对某些计算机类型的访问可能在组织级别受到限制。 通常,这样做是为了防止人们选择以较高费率计费的资源较高的计算机。 如果您的存储库受到组织级计算机类型策略的影响,则应确保不要设置最低规范,因为该规范不会留下任何可用的计算机类型供人们选择。 有关详细信息,请参阅“限制对计算机类型的访问”。

设置最低计算机规范

  1. 可以通过向 devcontainer.json 文件添加设置来配置为存储库创建的 codespace。 如果存储库尚未包含 devcontainer.json 文件,可以立即添加一个。 请参阅“将开发容器配置添加到存储库”。

  2. 编辑 devcontainer.json 文件,将属性 hostRequirements 添加到文件顶层,位于封闭的 JSON 对象内。 例如:

    JSON
    "hostRequirements": {
       "cpus": 8,
       "memory": "8gb",
       "storage": "32gb"
    }
    

    可以指定以下任何或所有选项:cpusmemorystorage

    要检查当前可用于存储库的 GitHub Codespaces 计算机类型的规范,请逐步完成创建 codespace 的过程,直到看到选择的计算机类型。 有关详细信息,请参阅“为存储库创建 codespace”。

  3. 保存文件并将更改提交到存储库的所需分支。

    现在,当你为存储库的该分支创建代码空间时,前往创建配置选项,只能选择与指定资源匹配或超过你指定的资源的计算机类型。

    计算机类型列表的屏幕截图。 2 核和 4 核选项标记为“低于开发容器要求”。

延伸阅读