Skip to main content

Alterando o tipo de máquina para seu codespace

Você pode alterar o tipo de computador que está executando o codespace para usar os recursos apropriados ao trabalho que está fazendo.

Sobre os tipos de máquina

Normalmente, você pode executar o codespace na sua escolha de tipos de computador remoto. Esses tipos de computador oferecem uma opção de especificações de hardware que variam de 2 a 32 núcleos, embora a gama completa de tipos de computador nem sempre esteja disponível. Cada tipo de computador tem um nível diferente de recursos e um tipo de cobrança diferente. Para obter mais informações, confira "Sobre a cobrança do GitHub Codespaces".

Por padrão, o tipo de computador com os recursos válidos mais baixos é usado quando você cria um codespace. Você pode escolher um tipo de computador alternativo ao criar um codespace ou a qualquer momento, depois de criar um codespace.

Para obter informações sobre como escolher um tipo de computador ao criar um codespace, confira "Como criar um codespace para um repositório".

Os codespaces não publicados (codespaces criados com base em um modelo que não estão vinculados a um repositório em GitHub Enterprise Cloud) sempre são executados em uma máquina virtual com as mesmas especificações. Não é possível alterar o tipo de computador de um codespace não publicado. Para obter mais informações, confira "Como criar um codespace com base em um modelo".

Como alterar o tipo de computador

Observação: Sua escolha de tipos de computador disponíveis pode ser limitada por vários fatores. Esses fatores podem incluir uma política configurada para a organização ou uma especificação mínima de tipo de computador para o repositório. Para obter mais informações, confira "Como restringir o acesso aos tipos de computadores" e "Como definir uma especificação mínima para computadores de codespace".

  1. Navegue até a página "Seus codespaces" em github.com/codespaces.

    O tipo de máquina atual para cada um dos seus codespaces é exibido.

    Lista "Seus codespaces"

  2. Clique nas reticências ( ) à direita do codespace que deseja modificar.

  3. Clique em Alterar tipo de computador.

    Opção de menu '"Alterar tipo de máquina"

  4. Se vários tipos de máquina estiverem disponíveis para seu codespace, escolha o tipo de máquina que você deseja usar.

    Caixa de diálogo que mostra tipos de máquinas disponíveis para escolher

  5. Clique em Atualizar codespace.

  1. No VS Code, abra a Paleta de Comandos com Command+Shift+P (Mac) ou Ctrl+Shift+P (Windows/Linux).

  2. Pesquise e selecione "Codespaces: Alterar tipo de máquina."

    Pesquisar um branch para criar um novo Codespaces

  3. Se você não estiver seguindo essas instruções em um codespace, clique no codespace que deseja alterar.

    Pesquisar um branch para criar um novo Codespaces

    Se você estiver seguindo essas instruções em um codespace, a alteração se aplicará ao codespace do trabalho atual.

  4. Clique no tipo de computador que você quer usar.

  5. Se você estiver alterando para um tipo de computador com uma capacidade de armazenamento diferente, será exibido um prompt perguntando se deseja continuar. Leia o prompt e clique em Sim para aceitar.

Você pode usar o comando gh codespace edit --machine MACHINE-TYPE-NAME da GitHub CLI para alterar o tipo de computador de um codespace. Para usar esse comando, primeiro você precisará descobrir os tipos de computador disponíveis para o codespace.

  1. Para ver a lista de codespaces, em um terminal, insira o comando a seguir.

    gh codespace list
    
  2. Opcionalmente, para localizar o tipo de computador atual de um codespace, insira o comando a seguir.

    gh api /user/codespaces/CODESPACE-NAME
    

    Substitua CODESPACE-NAME pelo nome permanente do codespace, por exemplo octocat-literate-space-parakeet-mld5. Os nomes permanentes são listados na coluna NAME na lista retornada por gh codespace list.

    Se for pedido que você solicite o escopo de codespace, siga as instruções no terminal.

    Os detalhes do computador atual são listados no campo machine.

  3. Para localizar os tipos de computador disponíveis para um codespace, insira o comando a seguir.

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

    Substitua CODESPACE-NAME pelo nome permanente do codespace, por exemplo octocat-literate-space-parakeet-mld5.

  4. Para alterar os tipos de computador de um codespace, insira o comando a seguir.

    gh codespace edit --machine MACHINE-TYPE-NAME
    

    Substitua MACHINE-TYPE-NAME pelo nome de um tipo de computador disponível para o codespace, por exemplo standardLinux32gb.

  5. Usando as teclas de direção, navegue até o codespace que deseja alterar e pressione Enter.

Se você alterou para uma máquina virtual com uma capacidade de armazenamento diferente (por exemplo, de 64 GB para 32 GB), o codespace não ficará disponível por um breve período enquanto o tipo de computador é alterado. Se o codespace estiver ativo no momento, ele será interrompido automaticamente. Quando a alteração for concluída, você poderá reiniciar o codespace em execução no novo tipo de computador.

Se você alterou para uma máquina virtual com a mesma capacidade de armazenamento, a alteração será aplicada na próxima vez que você reiniciar o codespace. Um codespace ativo não será interrompido automaticamente. Para obter mais informações de como reiniciar um codespace, confira "Como parar e iniciar um codespace".

Leitura adicional