Habilitar ou desabilitar o GitHub Codespaces em sua organização

Sobe como habilitar e desabilitar o GitHub Codespaces

O GitHub Codespaces está sempre disponível nos repositórios públicos de uma organização e qualquer usuário pode criar um codespace com base nesses repositórios. Se sua organização estiver em um plano do GitHub Free, o GitHub Codespaces estará sempre disponível nos repositórios privados da sua organização também e todos os usuários com acesso a esses repositórios poderão criar um codespace às suas próprias custas.

Se você for o proprietário de uma organização em um plano GitHub Team ou GitHub Enterprise Cloud, poderá escolher se deseja habilitar ou desabilitar GitHub Codespaces nos repositórios privados . Se você habilitar o GitHub Codespaces nesses repositórios, poderá escolher se deseja habilitar para todos os usuários ou para uma seleção de membros e colaboradores.

Ao habilitar o GitHub Codespaces, você pode ajudar seus membros e colaboradores a começar a trabalhar com projetos rapidamente, sem a necessidade de instalar muitas ferramentas e dependências localmente para começar a contribuir. No entanto, talvez você queira distribuir o GitHub Codespaces gradualmente em sua organização, habilitando-o para grupos de usuários por vez. Como alternativa, se você precisar cumprir as normas de segurança que exigem maior controle sobre o código privado em sua organização, convém desabilitar o GitHub Codespaces para todos os membros.

Se você tiver habilitado o GitHub Codespaces em repositórios privados internos para pelo menos alguns usuários, você poderá optar por pagar pelo uso desses usuários do GitHub Codespaces em todos os repositórios em sua organização. Para saber mais, confira Como escolher quem tem a propriedade e paga pelos codespaces em sua organização.

Se você não puder acessar as configurações para habilitar o GitHub Codespaces em sua organização, isso pode ser porque um proprietário da empresa desabilitou o GitHub Codespaces para sua organização. Para saber mais, confira Como impor políticas do GitHub Codespaces em sua empresa na documentação do GitHub Enterprise Cloud.

Pré-requisitos para habilitar o GitHub Codespaces

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 saber mais, 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.

Além disso, para permitir que os usuários criem codespaces, você deve garantir que 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" na documentação do GitHub Enterprise Cloud.

Note

Se você for um educador ou professor verificado, precisará habilitar o GitHub Codespaces de um GitHub Classroom para usar o Benefício educacional do Codespaces. Para saber mais, confira Usando o GitHub Codespaces com o GitHub Classroom.

Sobre como alterar suas configurações

Se você remover o acesso de um usuário ao GitHub Codespaces, o usuário não poderá abrir imediatamente os codespaces existentes criados com base nos repositórios privados . Se você estivesse pagando anteriormente por codespaces que o usuário havia criado a partir dos repositórios públicos da sua organização, a propriedade desses codespaces transferirá o usuário.

Antes de remover o acesso dos usuários, você deve alertar os usuários afetados. Se eles tiverem um trabalho não publicado em um codespace, eles poderão garantir que o trabalho seja enviado por push para um branch no repositório antes que eles percam o acesso.

Depois que um usuário perde o acesso a um codespace, o codespace é retido por um período de sete dias e, em seguida, é excluído permanentemente. Durante esse período de sete dias, para recuperar o trabalho não publicado do codespace, o usuário deve entrar em contato com conosco por meio do Portal de suporte do GitHub.