关于机器类型
通常,你可以在多种远程机器类型上运行你的 Codespace。这些机器类型提供了从 2 核到 32 核的硬件规格选择,但可能无法始终使用所有机器类型。每种机器类型都有不同的资源级别和不同的计费层级。有关信息,请参阅“关于 GitHub Codespaces 的计费”。
默认情况下,在你创建 Codespace 时,将使用具有最低有效资源的机器类型。你可以在创建 Codespace 时或在创建 Codespace 后的任何时间选择备用机器类型。
有关在创建 Codespace 时选择机器类型的信息,请参阅“为存储库创建 Codespace”。
未发布的 Codespace(从未链接到 GitHub 上存储库的模板创建的 Codespace)始终在具有相同规格的虚拟机上运行。你无法更改未发布 Codespace 的机器类型。有关更多信息,请参阅“从模板创建 Codespace”。
更改机器类型
注意:你对可用机器类型的选择可能受到多种因素的限制。其中包括为你的组织配置的策略,或你的存储库的最低机器类型规格。有关更多信息,请参阅“限制对机器类型的访问”和“为 Codespace 机器设置最低规格”。
-
在 GitHub.com 的左上角,选择 ,然后单击 Codespaces 以转到 github.com/codespaces 上的“你的 Codespaces”页面。
每个 Codespace 都显示了内核数、内存、存储容量和当前已使用的存储。如果你使用的是窄浏览器窗口,则会省略一些详细信息。
-
单击要修改的 Codespace 右侧的省略号 (...)。
-
单击更改机器类型。
-
如果你的 Codespace 有多种机器类型可用,请选择你想要使用的机器类型。
-
单击更新 Codespace。
-
在 VS Code 中,使用 Command+Shift+P (Mac) 或 Ctrl+Shift+P (Windows/Linux) 打开命令面板。
-
搜索并选择“Codespaces: 更改机器类型”。
-
如果你不在 Codespace 中按照这些说明进行操作,请单击你要更改的 Codespace。
如果你在 Codespace 中按照这些说明进行操作,则更改将应用于你正在使用的 Codespace。
-
选择你要使用的机器类型。
-
如果你要更改为具有不同存储容量的机器类型,则会出现一个提示,询问你是否要继续。阅读提示,然后单击是以接受。
如果你已安装 GitHub CLI,则可以使用它来使用 GitHub Codespaces。有关 GitHub CLI 的安装说明,请参阅 GitHub CLI 存储库。
你可以使用 gh codespace edit --machine MACHINE-TYPE-NAME
GitHub CLI 命令来更改 Codespace 的机器类型。要使用此命令,你首先需要找出 Codespace 可用的机器类型。
-
要在终端中查看你的 Codespaces 列表,请输入以下命令。
gh codespace list
-
或者,要查找 Codespace 的当前机器类型,请输入以下命令。
gh api /user/codespaces/CODESPACE-NAME
将
CODESPACE-NAME
替换为 Codespace 的永久名称,例如literate-space-parakeet-w5vg5ww5p793g7g9
。永久名称列在gh codespace list
返回的列表中的名称列下。如果系统提示你请求
codespace
范围,请按照终端中的说明进行操作。当前机器的详细信息列在
machine
字段下。 -
要查找 Codespace 的可用机器类型,请输入以下命令。
gh api /user/codespaces/CODESPACE-NAME/machines
将
CODESPACE-NAME
替换为 Codespace 的永久名称,例如literate-space-parakeet-w5vg5ww5p793g7g9
。 -
要更改 Codespace 的机器类型,请输入以下命令。
gh codespace edit --machine MACHINE-TYPE-NAME
将
MACHINE-TYPE-NAME
替换为适用于你的代码空间的可用机器类型的名称,例如standardLinux32gb
。 -
使用箭头键导航到要更改的代码空间,然后按 Enter。
如果你更改为存储容量不同的虚拟机(例如,从 32 GB 更改为 64 GB),在更改机器类型时,你的代码空间将不可用一小段时间。如果代码空间当前处于活动状态,它将自动停止。更改完成后,你将能够重新启动在新的机器类型上运行的代码空间。
如果你更改为存储容量相同的虚拟机,则下次重新启动代码空间时将应用更改。活动代码空间不会自动停止。有关重新启动代码空间的更多信息,请参阅“停止和启动代码空间”。
延伸阅读
- “Codespaces 机器 REST API 端点”
gh codespace edit
在 GitHub CLI 手册中- “设置你的用户首选项”
- “管理你的代码空间”