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 的计算机类型。

重要

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

设置最低计算机规范

  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 核选项标记为“低于开发容器要求”。

其他阅读材料