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.

Who can use this feature

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

Os GitHub Codespaces estão disponíveis para organizações que usam o GitHub Team ou o GitHub Enterprise Cloud. GitHub Codespaces também está disponível como uma versão beta limitado para usuários individuais nos planos GitHub Free e GitHub Pro. Para obter mais informações, confira "produtos de GitHub".

Visão geral

Cada codespace criado é hospedado em uma máquina virtual separada e você geralmente pode escolher entre diferentes tipos de máquinas virtuais. Cada tipo de computador tem recursos diferentes (CPUs, 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.

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 são configurados em um arquivo devcontainer.json. Se o repositório ainda não contiver um arquivo devcontainer.json, adicione-o agora. Confira "Adicionar uma configuração de contêiner de desenvolvimento ao repositório".

  2. Edite o arquivo devcontainer.json, adicionando uma propriedade hostRequirements como esta:

    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".

  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