Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.

Definindo uma especificação mínima para máquinas de codespaces

Você pode evitar que tipos de computador com recursos insuficientes sejam usados nos GitHub Codespaces do repositório.

Quem pode usar esse recurso

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

Visão geral

Cada codespace que você cria é hospedado em uma máquina virtual separada. Ao criar um codespace de um repositório, você geralmente pode escolher entre diferentes tipos de máquinas virtuais. Cada tipo de computador tem recursos diferentes (núcleos de processador, memória, armazenamento) e, por padrão, o tipo de computador com menos recursos é usado. Para obter mais informações, confira "Como alterar o tipo de computador para seu codespace".

Se o seu projeto precisar de um nível de capacidade de computação específico, você poderá configurar GitHub Codespaces para que apenas os tipos de computador que atenderem a esses requisitos possam ser usados por padrão ou selecionados pelos usuários. Você configura isso em um arquivo devcontainer.json.

Os codespaces não publicados (codespaces criados com base em um modelo que não estão vinculados a um repositório em GitHub) 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.

Importante: o acesso a alguns tipos de computadores pode ser restrito no nível da organização. De modo geral, isso é feito para evitar que as pessoas escolham máquinas de maior recursos que são cobradas a uma taxa mais alta. Se seu repositório for afetado por uma política a nível da organização para tipos de máquinas, você deverá certificar-se de que não definiu uma especificação mínima que não deixaria nenhum tipo de máquina disponível para as pessoas escolherem. Para obter mais informações, confira "Como restringir o acesso aos tipos de computadores".

Definindo uma especificação mínima de máquina

  1. Os GitHub Codespaces do repositório podem ser configurados em um arquivo devcontainer.json. Se o repositório ainda não contiver um arquivo devcontainer.json, adicione um agora. Confira "Adicionando uma configuração de contêiner de desenvolvimento ao repositório".

  2. Edite o arquivo devcontainer.json, adicionando a propriedade hostRequirements no nível superior do arquivo, dentro do objeto JSON delimitador. Por exemplo:

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

    Você pode especificar uma ou todas as opções: cpus, memory e storage.

    Para verificar as especificações dos tipos de computador do GitHub Codespaces que estão disponíveis para o repositório no momento, siga o processo de criação de um codespace até que apareçam as opções de tipos de computador. Para obter mais informações, confira "Como criar um codespace para um repositório".

  3. Salve o arquivo e faça commit as alterações no branch necessário do repositório.

    Agora, quando você criar um codespace para esse branch do repositório e acessar as opções de configuração de criação, você só poderá selecionar os tipos de máquina que correspondem ou excedem os recursos que você especificou.

    Caixa de diálogo que mostra uma escolha limitada de tipos de máquina

Leitura adicional