Skip to main content

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

Você pode evitar que tipos de máquina com recursos insuficientes sejam usados no Codespaces para o seu repositório.

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

Codespaces is available for organizations using GitHub Team or GitHub Enterprise Cloud. Para obter mais informações, consulte os "produtos do GitHub".

Visão Geral

Cada codespace que você cria é hospedado em uma máquina virtual separada, e você geralmente pode escolher entre diferentes tipos de máquinas virtuais. Cada tipo de máquina tem recursos diferentes (CPUs, memória, armazenamento) e, por padrão, usa-se o tipo de máquina com menos recursos. Para obter mais informações, consulte ""Mudar o tipo de máquina para seu codespace."

Se o seu projeto precisar de um certo nível de poder de computação, você poderá configurar GitHub Codespaces para que somente os tipos de máquina que atendam 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 máquina 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, consulte "Restringindo o acesso aos tipos de máquina."

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

  1. Codespaces para o seu repositório está configurado em um arquivo devcontainer.json. Se o seu repositório ainda não contiver um arquivo devcontainer.json, adicione um agora. Consulte "Adicionar uma configuração de contêiner de desenvolvimento ao seu repositório".

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

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

    Você pode especificar qualquer uma ou todas as opções: cpus, memória e armazenamento.

    Para verificar as especificações dos tipos de máquina de Codespaces que estão atualmente disponíveis para o seu repositório, siga o processo de criação de um codespace até que você veja a escolha de tipos de máquina. Para obter mais informações, consulte "Criar um codespace".

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

    Agora, ao criar um codespace para o branch desse repositório e acessar as opções de configuração, você só poderá selecionar os tipos de máquina que coincidem ou excedem os recursos especificados.

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

Leia mais