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 obter mais informações, confira "Como escolher quem tem a propriedade e paga pelos codespaces em sua organização" e "Planos do GitHub."

Neste artigo

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 para a 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 Sobre o faturamento 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á tiverem 2 codespaces ativos ou interrompidos cobrados da sua organização terão que excluir um deles antes de poderem criar um codespace cobrado da 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 Sobre o faturamento do GitHub Codespaces. Para obter informações sobre como escolher quem pode criar codespaces que são cobrados da sua organização, confira Habilitar ou desabilitar o GitHub Codespaces em 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, selecione sua foto de perfil e selecione Suas organizações.

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

  3. Na seção "Código, planejamento e automação" da barra lateral, selecione Codespaces e clique em Políticas.

  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:

    Note

    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 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 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 Save (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.