Skip to main content

Restringindo o acesso aos tipos de máquina

Você pode definir restrições sobre os tipos de máquinas que os usuários podem escolher ao criarem os codespaces na sua organização.

Who can use this feature

To manage access to machine types for the repositories in an organization, you must be an owner of the organization.

Visão geral

Normalmente, ao criar um codespace, você tem uma escolha de especificações para a máquina que executará seu codespace. Você pode escolher o tipo de máquina que melhor se adapte às suas necessidades. Para obter mais informações, confira "Como criar um codespace para um repositório".

Se você pagar por usar o GitHub Codespaces, a escolha do tipo de máquina vai afetar a sua cobrança. O custo de computação de um codespace é proporcional ao número de núcleos de processador no tipo de computador escolhido. Por exemplo, o custo de computação de usar um codespace por uma hora em um computador de 16 núcleos é oito vezes maior que em um computador de dois núcleos. Para ver mais informações sobre preços, confira "Sobre a cobrança do GitHub Codespaces".

Como proprietário da organização, você deverá configurar restrições sobre os tipos de máquina disponíveis. Por exemplo, se o trabalho na sua organização não exigir energia de computação ou espaço de armazenamento significativo, você poderá remover as máquinas com muitos recursos da lista de opções que as pessoas podem escolher. Faça isso definindo uma ou mais políticas nas configurações dos GitHub Codespaces da organização.

Comportamento quando você define uma restrição de tipo de máquina

Se houver codespaces que não estão mais em conformidade com uma política que você definiu, esses codespaces continuarão operando até que sejam interrompidos ou atinjam o tempo limite. Quando o usuário tentar retomar o codespace, será mostrada uma mensagem informando que o tipo de computador selecionado não é mais permitido nessa organização e solicitando que ele escolha um tipo de computador alternativo.

Se você remover mais tipos de máquina de especificação exigidos pela configuração de GitHub Codespaces para um repositório individual na organização, não será possível criar um codespace para esse repositório. Quando alguém tentar criar um codespace, verá uma mensagem dizendo que não há tipos de máquina válidos disponíveis que atendam aos requisitos da configuração de GitHub Codespaces do repositório.

Observação: qualquer pessoa que possa editar o arquivo de configuração devcontainer.json em um repositório pode definir uma especificação mínima para os computadores que podem ser usados para os codespaces desse repositório. Para obter mais informações, confira "Como configurar uma especificação mínima para os computadores do codespace".

Se a configuração de uma política para tipos de máquina impedir que as pessoas usem GitHub Codespaces para um repositório em particular, há duas opções:

  • É possível ajustar suas políticas para remover especificamente as restrições do repositório afetado.
  • Qualquer pessoa que tenha um codespace ao qual nao tem mais acesso devido à nova política, pode exportar o seu codespace para um branch. Esta branch conterá todas as alterações feitas no codespace. Será possível abrir um novo codespace nesse branch com um tipo de máquina compatível ou trabalhar localmente neste branch. Para obter mais informações, confira "Como exportar alterações para um branch".

Definindo políticas específicas da organização e do repositório

Ao criar uma política, você define se ela se aplica a todos os repositórios da organização ou apenas a repositórios específicos. Se você definir uma política para toda a organização, todas as políticas que você definir para repositórios individuais devem estar dentro da restrição definida no nível da organização. A adição de políticas torna a escolha de máquinas mais restritiva.

Por exemplo, você poderia criar uma política para toda a organização que restringisse os tipos de máquina a 2 ou 4 núcleos. Em seguida, você pode definir uma política para o Repositório A que o restrinja a apenas máquinas com 2 núcleos. Definir uma política para o Repositório A que o restringiu a máquinas com 2, 4, ou 8 núcleos resultariam em uma escolha de máquinas com apenas 2 ou 4 núcleos, porque a política de toda a organização impede o acesso a máquinas com 8 núcleos.

Se você adicionar uma política para toda a organização, você deverá configurá-la para a maior escolha de tipos de máquina que estarão disponíveis para qualquer repositório na sua organização. Em seguida, você pode adicionar políticas específicas ao repositório para restringir ainda mais a escolha.

Observação: as políticas de codespace só se aplicam aos que são cobrados na organização. Se um usuário individual criar um codespace para um repositório em sua organização e a organização não for cobrada, o codespace não será associado a essas políticas. Para obter informações sobre como escolher quem pode criar codespacaes que são cobrados para sua organização, confira "Como habilitar GitHub Codespaces para sua organização".

Adicionar uma política para limitar os tipos de máquina disponíveis

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e clique em Suas organizações. Suas organizações no menu de perfil 2. Ao lado da organização, clique em Configurações. Botão de configurações 1. Na seção "Código, planejamento e automação" da barra lateral, selecione Codespaces e clique em Políticas.

  2. Na página "Políticas de codespace", clique em Criar Política.

  3. Insira um nome para sua nova política.

  4. Clique em Adicionar restrição e escolha Tipos de computadores.

    Captura de tela do menu suspenso 'Adicionar restrição'

  5. Clique em para editar a restrição e, em seguida, limpe a seleção de todos os tipos de máquina que você não deseja que estejam disponíveis.

    Captura de tela do ícone de lápis para editar a restrição

  6. Na área "Alterar destino da política", clique no botão suspenso.

  7. Escolha Todos os repositórios ou Repositórios selecionados para determinar a quais repositórios essa política se aplicará.

  8. Se você escolheu Repositórios selecionados:

    1. Clique em .

      Editar as configurações da política

    2. Selecione os repositórios aos quais você quer que esta política seja aplicada.

    3. Na parte inferior da lista de repositórios, clique em Selecionar repositórios.

      Selecionar repositórios para esta política

  9. Para adicionar outra restrição à política, clique em Adicionar restrição e escolha outra restrição. Para obter informações sobre outras restrições, confira:

  10. Depois de concluir a adição de restrições à política, clique em Salvar.

A política será aplicada a todos os codespaces que podem ser cobrados da sua organização. A restrição de tipo de computador também é aplicada a codespaces existentes quando alguém tenta reiniciar um codespace interrompido ou reconectar-se a um codespace ativo.

Editando uma política

Você pode excluir ou editar uma política existente. Por exemplo, você talvez queira adicionar restrições a ou removê-las de uma política.

  1. Exibir a página "Políticas de codespaces". Para obter mais informações, confira "Como adicionar uma política para limitar os tipos de computadores disponíveis".
  2. Clique no nome da política que você deseja editar.
  3. Clique no ícone de lápis () ao lado da restrição "Tipos de computador".
  4. Faça as alterações necessárias e clique em Salvar.

Excluindo uma política

  1. Exibir a página "Políticas de codespaces". Para obter mais informações, confira "Como adicionar uma política para limitar os tipos de computadores disponíveis".

  2. Clique no botão excluir à direita da política que você deseja excluir.

    Captura de tela do botão excluir de uma política

Leitura adicional