Criando codespaces
Sem acesso para criar um codespace
GitHub Codespaces não está disponível para todos os repositórios. Se as opções para criar um codespace não forem exibidas, GitHub Codespaces talvez não estejam disponíveis para esse repositório.
Se você ainda tiver uso mensal incluído restante de GitHub Codespaces na sua conta pessoal, ou tiver configurado uma forma de pagamento e um limite de gastos, poderá criar um codespace para qualquer repositório público.
Você também pode criar um codespace para qualquer repositório privado ao qual tenha pelo menos acesso de leitura, desde que esse repositório privado seja de propriedade de uma conta pessoal. Se um repositório for privado ou interno e pertencer a uma organização, você poderá ou não ser capaz de criar um codespace para esse repositório, dependendo das configurações da organização ou de sua empresa pai.
Se você não puder criar um codespace para um repositório, isso pode ser devido a uma das configurações a seguir da organização ou empresa.
- Os proprietários da organização e da empresa podem escolher quais usuários podem acessar GitHub Codespaces nos repositórios privados e internos de uma organização. Para saber mais, confira Habilitar ou desabilitar GitHub Codespaces para sua organização.
- Os proprietários de organizações e empresas podem desabilitar a bifurcação para alguns ou todos os repositórios privados e internos de uma organização. Se você só tiver acesso de leitura a um repositório e não puder bifurcá-lo, não poderá criar um codespace para esse repositório. Para obter mais informações, consulte Gerenciando a política de bifurcação da sua organização.
- Se você tiver um conta de usuário gerenciada, não poderá criar codespaces para seus repositórios pessoais, a menos que o repositório seja uma bifurcação de um repositório pertencente à organização e você tenha permissão para usar GitHub Codespaces por conta da organização. Para saber mais, confira Sobre os Enterprise Managed Users.
Para obter informações sobre outras configurações organizacionais e empresariais que podem afetar a sua capacidade de criar um codespace, consulte Habilitar ou desabilitar GitHub Codespaces para sua organização.
Para obter mais informações sobre o uso incluído em contas pessoais e como definir um limite de gastos, consulte Cobrança do GitHub Codespaces e Definir orçamentos para controlar gastos com produtos limitados.
O codespace não abre quando criado
Se você criar um codespace e ele não abrir:
- Tente atualizar a página no caso de haver um problema de cache ou comunicação.
- Vá para sua GitHub Codespaces página: https://github.com/codespaces e verifique se o novo codespace está listado lá. O processo pode ter criado com sucesso o codespace, mas não foi possível reportar ao seu navegador. Se o novo codespace estiver listado, você poderá abri-lo diretamente a partir daquela página.
- Tente criar o código novamente para que o repositório exclua uma falha de comunicação temporária.
Se você ainda não conseguir criar um codespace para um repositório em que GitHub Codespaces está disponível, talvez você precise entrar em contato com o suporte. Para saber mais, confira Trabalhando com suporte para GitHub Codespaces.
Falha na criação do codespace
Se a criação de um codespace falhar, provavelmente será devido a um problema temporário de infraestrutura na nuvem, por exemplo, um problema ao provisionar uma máquina virtual para o codespace. Um motivo menos comum para a falha é se leva mais de uma hora para compilar o contêiner. Nesse caso, o build será cancelado e a criação do codespace falhará.
Observação
Um codespace que não foi criado com sucesso nunca será utilizável e deve ser excluído. Para saber mais, confira Excluir um codespace.
Se você criar um codespace e a criação falhar:
-
Vá para sua GitHub Codespaces página, exclua o codespace e crie um novo codespace.
-
Se o contêiner está sendo compilado, examine os logs que estão sendo transmitidos e verifique se o build não está travado. Um build de contêiner que leva mais de uma hora será cancelado, resultando em falha na criação.
Um cenário comum em que isso pode acontecer é se você tem um script em execução que está solicitando a entrada do usuário e aguardando uma resposta. Se esse for o caso, remova o prompt interativo para que o build possa ser concluído de maneira não interativa.
Observação
Para visualizar os registros durante uma compilação: * No navegador, se as etapas iniciais do processo de compilação levarem mais de alguns segundos, a página "Configurando seu codespace" será exibida. Clique em Exibir logs.
No aplicativo para desktop VS Code, clique em Construindo codespace na mensagem pop-up "Configurando conexão remota" exibida.
As mensagens de log são impressas no Terminal em VS Code
- Se você tiver um contêiner que leva muito tempo para ser compilado, considere o uso de pré-compilações para acelerar as criações de codespace. Para saber mais, confira Configurando as pré-compilações.
Excluindo codespaces
Um codespace só pode ser excluído:
- A pessoa que criou o codespace
- Um proprietário da organização para um codespace de propriedade da organização
- Exclusão automática ao término de um período de retenção
Para saber mais, confira Excluir um codespace e Como configurar a exclusão automática de seus codespaces.
Armazenamento do contêiner
Ao criar um codespace, ele terá uma quantidade limitada de armazenamento e, após um tempo, poderá ser necessário que você libere espaço. Tente executar qualquer um dos comandos a seguir no GitHub Codespaces terminal para liberar espaço de armazenamento.
- Remova os pacotes que não são mais usados com
sudo apt autoremove. - Limpe o cache apt usando
sudo apt clean. - Veja os dez maiores arquivos no codespace com
sudo find / -printf '%s %p\n'| sort -nr | head -10. - Exclua arquivos desnecessários, como artefatos e registros de criação.
Algumas opções mais destrutivas:
- Remova imagens, redes e contêineres do Docker não utilizados usando
docker system prune(acrescente-ase quiser remover todas as imagens e--volumesse quiser remover todos os volumes). - Remova os arquivos sem controle de alterações da árvore de trabalho:
git clean -i.
Configuração
Se as alterações na configuração do seu contêiner de desenvolvimento causarem um erro no contêiner, seu codespace será executado no modo de recuperação, e você verá uma mensagem de erro.
This codespace is currently running in recovery mode due to a container error.
Examine os logs de criação e atualize a configuração do contêiner de desenvolvimento conforme necessário. Para saber mais, confira Logs do GitHub Codespaces.
Em seguida, você pode tentar reiniciar o codespace ou recompilar o contêiner. Para obter mais informações sobre como recompilar o contêiner, consulte Introdução aos contêineres de desenvolvimento.