Skip to main content

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

Você pode controlar quais usuários podem usar o GitHub Codespaces nos repositórios privados e internos do .

Quem pode usar esse recurso?

Organization owners can control which users can use GitHub Codespaces.

Organizations on GitHub Team and GitHub Enterprise plans can choose to disable GitHub Codespaces in private and internal repositories. For more information, see "Planos do GitHub."

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 e internos do . 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 e 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 obter mais informações, 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 obter mais informações, confira "Como impor políticas do GitHub Codespaces em sua empresa."

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

Além disso, para permitir que os usuários criem codespaces, você deve garantir que:

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 e internos de sua organização . 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.

Habilitar ou desabilitar o GitHub Codespaces

Observação: 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 e internos de sua organização . Para obter mais informações, confira "Sobre como alterar suas configurações".

  1. No canto superior direito do GitHub.com, selecione sua foto do perfil e em Suas organizações.

    Captura de tela do menu suspenso na imagem de perfil do @octocat. "Suas organizações" está contornado em laranja escuro.

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

  3. Na barra leral esquerda, clique em Codespaces.

  4. Em Codespaces, na barra lateral esquerda, clique em Geral.

  5. Na página de configurações do Codespaces, em "Acesso a codespaces", selecione sua configuração preferida para GitHub Codespaces nos repositórios privados e internos do .

    Você pode desabilitar o Codespaces, habilitar para membros ou equipes específicos, habilitar para todos os membros ou habilitar para todos os membros e colaboradores.