Skip to main content

Restringir o número de codespaces cobrados pela organização que um usuário pode criar

Você pode especificar o número máximo de codespaces que qualquer membro da sua organização ou colaborador pode criar para os repositórios em sua organização.

Quem pode usar esse recurso?

To manage this constraint for an organization, you must be an owner of the organization.

As organizações com os planos do GitHub Team e do GitHub Enterprise podem pagar pelo uso de membros e colaboradores do GitHub Codespaces. Depois, essas organizações podem acessar configurações e políticas para gerenciar codespaces pagos pela organização. Para saber mais, confira Como escolher quem tem a propriedade e paga pelos codespaces em sua organização e Planos do GitHub.

Visão geral

Por padrão, se os membros da organização ou colaboradores tiverem permissão para criar codespaces faturáveis para sua organização, eles poderão criar vários desses codespaces. O número de codespaces cobrados pela organização que alguém pode criar é regido por um limite para o número total de codespaces que eles podem criar em todos os repositórios que podem acessar. Esse limite é definido por GitHub.

Como proprietário da organização, você pode restringir o número de codespaces que cada usuário pode criar, em que os custos do codespace são faturáveis à organização. Isso pode ajudar a reduzir o custo geral do GitHub Codespaces para a organização, pois há uma cobrança pelo armazenamento de codespace. Para saber mais, confira Cobrança do GitHub Codespaces.

Para restringir o número máximo de codespaces cobrados pela organização que os usuários podem criar, crie uma política nas configurações do Codespaces para sua organização. Por exemplo, se você definir o máximo como 2, os usuários que já têm 2 codespaces ativos ou interrompidos cuja cobrança é feita pela sua organização terão que excluir um deles antes de poderem criar um novo codespace, cuja cobrança é feita pela organização.

Essa configuração não impede que os usuários criem codespaces que não são cobrados para sua organização. Por exemplo, eles podem criar codespaces adicionais para repositórios públicos, usando sua permissão de uso de Codespaces pessoal. No entanto, os usuários que têm permissão para criar codespaces cobrados pela organização, mas atingiram o limite para tais codespaces, não podem optar por criar um codespace para um repositório de propriedade da organização usando sua permissão incluída pessoal.

Para obter informações sobre o uso gratuito do GitHub Codespaces para contas pessoais, confira Cobrança do GitHub Codespaces. Para obter informações sobre como escolher quem pode criar codespaces que são cobrados da sua organização, consulte Habilitar ou desabilitar GitHub Codespaces para sua organização".

As políticas com a restrição "Máximo de codespaces por usuário" são aplicadas a todos os repositórios em sua organização. Portanto, você não pode adicionar essa restrição a uma política existente configurada para ser aplicada somente a repositórios selecionados.

Adicionar uma política para definir o máximo de codespaces por usuário

  1. No canto superior direito de GitHub, clique na foto de perfil e clique em Your organizations.

  2. Ao lado da organização, clique em Configurações.

  3. Na seção "Code, planning, and automation" da barra lateral, selecione Codespaces e clique em Policies.

  4. Na página "Políticas de codespaces", clique em Criar Política.

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

  6. Clique em Adicionar restrição e escolha Máximo de codespaces por usuário.

  7. Clique em para editar a restrição.

  8. No campo "Valor máximo", insira o número máximo de codespaces cobrados pela organização que cada usuário pode criar.

    Captura de tela da caixa de diálogo 'Valor máximo' com o valor '2' sendo inserido e os botões 'Cancelar' e 'Salvar'.

  9. Clique em Salvar.

  10. 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: * Restringindo o acesso aos tipos de máquina * Como restringir a imagem base dos codespaces * Como restringir a visibilidade das portas encaminhadas * Restringir o período de tempo limite ocioso * Como restringir o período de retenção de codespaces

    Observação

    Ao adicionar uma restrição a uma política que já contém a restrição "Máximo de codespaces por usuário", você não poderá restringir a restrição adicional a repositórios específicos, pois a restrição "Máximo de codespaces por usuário" se aplica a todos os repositórios da organização.

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

A política é aplicada quando qualquer pessoa tenta criar um codespace que pode ser cobrado para sua organização.

Editando uma política

Você pode 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 Adicionar uma política para definir o máximo de codespaces por usuário.
  2. Clique no nome da política que você deseja editar.
  3. Ao lado da restrição "Máximo de codespaces por usuário", clique em .
  4. Edite o número máximo de codespaces.
  5. Clique em Salvar.

Excluindo uma política

  1. Exibir a página "Políticas de codespaces". Para obter mais informações, confira Adicionar uma política para definir o máximo de codespaces por usuário.
  2. Clique em à direita da política que você deseja excluir.