Como habilitar o GitHub Codespaces em sua organização

Sobre habilitar GitHub Codespaces para a sua organização

Os proprietários de organizações com os planos do GitHub Team e do GitHub Enterprise podem permitir que alguns usuários criem e usem codespaces às custas da organização. Isso se aplica aos codespaces criados com base em repositórios pertencentes à organização. Para obter mais informações, confira "Produtos do GitHub" e "Sobre o faturamento do GitHub Codespaces."

Se um usuário puder acessar um dos repositórios da sua organização, mas você não tiver permitido que ele crie um codespace às custas da sua organização, o usuário ainda poderá criar codespaces por meio do repositório. Esses codespaces vão gerar um uso na conta pessoal do usuário.

Independentemente de quem paga por um codespace, somente as pessoas que podem enviar alterações por push para um repositório ou bifurcar o repositório podem criar um codespace para esse repositório. Para permitir que um usuário crie codespaces para um repositório de propriedade de sua organização, siga uma das orientações a seguir.

• Verifique se o usuário tem acesso de leitura ao repositório e se o repositório permite o fork, para que seja possível criar um codespace com base no repositório, enviar as alterações para um fork e criar uma solicitação de pull com relação a quaisquer alterações necessárias. Para obter mais informações, confira "Gerenciar a política de bifurcação da sua organização".
• Verifique se o usuário tem acesso de gravação ao repositório, para que seja possível enviar alterações diretamente ao repositório, sem fork.

Você também precisa garantir que:

• A empresa não use OIDC com CAP. Para obter informações, confira "Sobre o suporte para a política de acesso condicional do IdP."
• A organização não tem uma lista de endereços IP permitidos habilitada. Para obter mais informações, confira "Como gerenciar endereços IP permitidos para sua organização".

Para permitir que as pessoas criem codespaces pelos quais sua organização será cobrada, você deve:

• Definir um limite de gastos
• Escolha quem pode criar codespaces cobrados da sua organização

Quando tiver definido um limite de gastos, você poderá acessar as configurações do GitHub Codespaces nas configurações da sua organização e nos repositórios pertencentes à sua organização. Por exemplo, você pode configurar pré-builds para um repositório ou definir uma política para restringir a imagem base ou o tipo de computador que pode ser usado nos codespaces da sua organização. Essas políticas se aplicam aos codespaces que a sua organização paga, mas não aos codespaces criados com base nos repositórios que são cobrados para a conta pessoal de um usuário.

Use também a API REST para gerenciar os codespaces pertencentes à sua organização, por exemplo, para interromper ou excluir um codespace. Para obter mais informações, confira "Organizações de codespaces" na documentação da API REST.

Por padrão, um codespace só pode acessar o repositório no qual ele foi criado. Se você quiser que os codespaces da sua organização possam acessar outros repositórios da organização que o criador do codespace pode acessar, confira "Gerenciando o acesso ao repositório para os codespaces da sua organização".

Escolha quem pode criar codespaces que são cobrados da sua organização

1. No canto superior direito do GitHub.com, clique na foto do seu perfil e clique em Suas organizações.

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

   1. Na barra leral esquerda, clique em Codespaces. 1. Em Codespaces, na barra lateral esquerda, clique em Geral.

2. Na página de configurações de Codespaces, em "Cobrança", selecione uma das seguintes opções:

   • Desabilitado – Sua organização não será cobrada pelo uso do codespace. Codespaces criados para os repositórios da sua organização, e serão cobrados dos usuários individuais que os criaram.
   • Membros selecionados – Codespaces criados para os repositórios da sua organização por membros selecionados serão cobrados na organização.
   • Todos os membros – Codespaces criados para os repositórios da sua organização por membros da sua organização serão cobrados da organização.
   • Todos os membros e colaboradores externos – Codespaces criados para os repositórios da sua organização por membros da organização e colaboradores externos serão cobrados da organização.

   Observação: quando você seleciona Todos os membros e colaboradores externos, todos os colaboradores externos que foram adicionados a repositórios específicos podem criar e usar o Codespaces para esses repositórios, e a sua organização será cobrada por esse uso. Para saber mais sobre gestão de colaboradores externos, confira "Adicionar colaboradores externos a repositórios em sua organização".

3. Clique em Salvar.

4. Se você escolheu Membros selecionados, uma caixa de entrada será exibida para que você insira os nomes dos usuários que deseja selecionar.

   

Desabilitando Codespaces para sua organização

Você pode impedir a criação e o uso de codespaces faturáveis para sua organização.

1. No canto superior direito do GitHub.com, clique na foto do seu perfil e clique em Suas organizações.

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

   1. Na barra leral esquerda, clique em Codespaces. 1. Em Codespaces, na barra lateral esquerda, clique em Geral.

2. Na página de configurações de Codespaces, em "Cobrança", selecione Desabilitar.

Definindo um limite de gastos

Por padrão, todas as contas têm um limite de gastos de US$ 0 para GitHub Codespaces. Isso impede que novos codespaces sejam criados ou que os codespaces existentes sejam abertos, se isso incorrer em um custo faturável para sua conta pessoal, corporativa ou da organização. Para contas pessoais, os codespaces sempre poderão ser criados e usados se a conta não tiver atingido o limite de uso mensal incluído. Para organizações e empresas, o limite de gastos padrão significa que, para permitir que as pessoas criem codespaces que são cobrados para a organização ou sua empresa-mãe, o limite precisa ser alterado para um valor acima de US$ 0.

Para obter informações sobre como gerenciar e alterar o limite de gastos da sua conta, confira "Gerenciar o limite de gastos do GitHub Codespaces".