跳至主要内容

更改 codespace 的机器类型

您可以更改运行 codespace 的机器类型,以便使用适合您正在执行的工作的资源。

关于机器类型

通常,您可以在各种远程机器类型上运行您的 codespace。这些机器类型提供从 2 核到 32 核的硬件规格选择,尽管并非总是可以提供所有机器类型。每种机器类型都有不同的资源级别和不同的计费层级。有关信息,请参阅“GitHub Codespaces 的计费说明”。

默认情况下,创建 codespace 时使用具有最低有效资源的机器类型。您可以在创建 codespace 时或在创建 codespace 之后随时选择其他机器类型。

有关在创建 codespace 时选择机器类型的更多信息,请参阅“为代码库创建 codespace”。

未发布的 codespaces(从模板创建且未链接到 GitHub 上代码库的 codespaces)始终在具有相同规格的虚拟机上运行。您无法更改未发布 codespace 的机器类型。有关更多信息,请参阅“从模板创建 codespace”。

更改机器类型

注意

可用的机器类型选择可能会受到多种因素的限制。这些因素可能包括为您的组织配置的策略,或您代码库的最低机器类型规格。有关更多信息,请参阅“限制对机器类型的访问”和“设置 codespace 机器 的最低规格”。

  1. 在 GitHub 的左上角,选择,然后单击 Codespaces,这将带您进入 github.com/codespaces 上的“您的 codespaces”页面。

    每个 codespace 都显示了核心数、内存、存储容量和当前使用的存储量。如果您使用的是窄浏览器窗口,则某些详细信息会被省略。

    Screenshot of a list of three codespaces on the https://github.com/codespaces page."

  2. 点击要修改的 codespace 右侧的省略号 (**...**)。

  3. 点击**更改机器类型**。

    Screenshot of the dropdown menu for a codespace. The "Change machine type" option is highlighted.

  4. 如果您的 codespace 可用多种机器类型,请选择您要使用的机器类型。

    Screenshot of a dialog showing two available machine types: 2-core and 4-core.

  5. 点击**更新 codespace**。

  1. 在 VS Code 中,使用Command+Shift+P(Mac)或Ctrl+Shift+P(Windows/Linux)打开命令面板。

  2. 搜索并选择“Codespaces:更改机器类型”。

    Screenshot of "change machine" entered as a search string and "Codespaces: Change Machine Type" in the dropdown list.

  3. 如果您不是在 codespace 中按照这些说明操作,请点击您要更改的 codespace。

    Screenshot of a dropdown list of four codespaces.

    如果您是在 codespace 中按照这些说明操作,则更改将应用于您正在使用的 codespace。

  4. 选择您要使用的机器类型。

  5. 如果您要更改为存储容量不同的机器类型,则会弹出一个提示,询问您是否要继续。阅读提示并点击**是**以接受。

如果您已安装 GitHub CLI,则可以使用它来处理 GitHub Codespaces。有关 GitHub CLI 安装说明,请参阅GitHub CLI 存储库

您可以使用gh codespace edit --machine MACHINE-TYPE-NAME GitHub CLI 命令来更改 codespace 的机器类型。要使用此命令,您首先需要找出 codespace 可用的机器类型。

  1. 要查看您的 codespace 列表,请在终端中输入以下命令。

    gh codespace list
    
  2. 可选:要查找 codespace 的当前机器类型,请输入以下命令。

    gh api /user/codespaces/CODESPACE-NAME
    

    CODESPACE-NAME替换为 codespace 的永久名称,例如literate-space-parakeet-w5vg5ww5p793g7g9。永久名称列在gh codespace list返回的列表的**名称**列下。

    如果系统提示您请求codespace范围,请按照终端中的说明操作。

    当前机器的详细信息列在machine字段下。

  3. 要查找 codespace 可用的机器类型,请输入以下命令。

    gh api /user/codespaces/CODESPACE-NAME/machines
    

    CODESPACE-NAME替换为 codespace 的永久名称,例如literate-space-parakeet-w5vg5ww5p793g7g9

  4. 要更改 codespace 的机器类型,请输入以下命令。

    gh codespace edit --machine MACHINE-TYPE-NAME
    

    MACHINE-TYPE-NAME替换为 codespace 可用的机器类型名称,例如standardLinux32gb

  5. 使用箭头键导航到要更改的 codespace,然后按Enter

如果您更改为存储容量不同的虚拟机(例如,从 32 GB 更改为 64 GB),则在更改机器类型期间,您的 codespace 将短暂不可用。如果 codespace 当前处于活动状态,它将自动停止。更改完成后,您将能够重新启动在新的机器类型上运行的 codespace。

如果您更改为存储容量相同的虚拟机,则下次重新启动 codespace 时将应用更改。活动 codespace 不会自动停止。有关重新启动 codespace 的更多信息,请参阅“停止和启动 codespace”。