Skip to main content

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 "Alterando o tipo de máquina 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 "Restringindo o acesso aos tipos de máquina".

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

  1. Configure os codespaces criados para seu repositório adicionando configurações a 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.

    Captura de tela de uma lista de tipos de computador. As opções de 2 e 4 núcleos são rotuladas como "Abaixo dos requisitos do contêiner de desenvolvimento".

Leitura adicional