Skip to main content

Solução de problemas com sua conexão com o GitHub Codespaces

Solução de problemas de ajuda para você a se conectar ao GitHub Codespaces.

503 codespace service unavailable

Os codespaces são definidos para parar após 30 minutos sem atividade. Se você tentar interagir com um codespace depois que ele for interrompido, poderá receber um erro 503 service unavailable.

  • Se um botão Iniciar for mostrado no Visual Studio Code ou na janela do navegador, clique em Iniciar para se reconectar ao codespace.
  • Redefina o seu codespace recarregando a janela. Na paleta de comandos do Visual Studio Code, clique em Desenvolvedor: recarregar Janela.

Não foi possível conectar o navegador

Às vezes, é possível que você não consiga acessar um codespace a partir do seu navegador. Se isso acontecer, acesse https://github.com/codespaces e tente se conectar ao codespace por meio dessa página.

  • Se o codespace não estiver listado nessa página, verifique se você é o proprietário do codespace que ao qual você está tentando se conectar. Você só pode abrir um codespace que você criou.
  • Se o codespace estiver listado, mas você não puder conectar-se a partir dessa página, verifique se você pode conectar-se usando um navegador diferente.

Diagnosticar por mensagem de erro

"Parece que você está offline"

Verifique se a conexão de internet é estável e se a rede da sua empresa não está bloqueando a conexão. Se possível, verifique se há registros relacionados à rejeição de conexão no seu dispositivo.

Em caso afirmativo, verifique se os domínios documentados pelo ponto de extremidade de API REST /meta não estão sendo bloqueados pelo firewall. Para saber mais, confira Pontos de extremidade da API REST para metadados.

Para obter a lista de domínios exigidos pelos GitHub Codespaces, execute o seguinte comando usando GitHub CLI:

gh api meta | jq .domains.codespaces

"Estamos enfrentando problemas para buscar suas informações do codespace"

Esse erro é transitório. Aguarde alguns minutos e tente novamente.

"Não foi possível autenticar sua conexão"

Isso indica que algo deu errado com a autenticação. Limpe o armazenamento local e os cookies e tente novamente.

Se ainda não conseguir se conectar e a mensagem exibida não estiver nessa lista, verifique a disponibilidade de serviço dos Codespaces em githubstatus.com. Se o serviço dos Codespaces estiver disponível, talvez você precise entrar em contato com o suporte. Para obter mais informações, confira "Como trabalhar com o suporte para o GitHub Codespaces".

Não é possível se conectar ao codespace no JupyterLab

Para poder usar um codespace no JupyterLab, você precisa garantir que ele esteja instalado no codespace. A imagem de contêiner de desenvolvimento padrão usada pelos GitHub Codespaces inclui o JupyterLab, mas se você tiver personalizado a configuração do contêiner de desenvolvimento, precisará instalar manualmente o JupyterLab.

Se o codespace usa uma imagem baseada em Debian, você pode instalar o JupyterLab no contêiner de desenvolvimento adicionando o recurso python ao arquivo devcontainer.json, com a opção installJupyterlab definida como true. Caso contrário, instale-o diretamente no Dockerfile. Para obter instruções sobre instalação, confira Instalação na documentação do JupyterLab.

Para obter mais informações sobre o recurso python, confira a página LEIAME no repositório devcontainers/features. Para saber mais sobre o arquivo devcontainer.json e o Dockerfile, confira Introdução aos contêineres de desenvolvimento.

Se você ainda não conseguir conectar-se, talvez você precise entrar em contato com o suporte. Para obter mais informações, confira "Como trabalhar com o suporte para o GitHub Codespaces".

a extensão de GitHub Codespaces para Visual Studio Code não poderá conectar

Se você não consegue conectar-se a um codespace a partir da área de trabalho de Visual Studio Code, siga as etapas de solução de problemas a seguir.

  1. Verifique se você tem a versão mais recente da extensão de GitHub Codespaces instalada. A extensão é uma versão de pré-visualização e atualizações frequentes são lançadas.
    1. Em Visual Studio Code, exiba a aba "Extensões".
    2. Selecione a extensão GitHub Codespaces para exibir a página de visão geral da extensão.
    3. Se uma atualização estiver disponível, um botão será mostrado. Clique em Atualizar para X.X.X para atualizar para a última versão.
  2. Verifique se você está usando o build estável do Visual Studio Code ou a versão Visual Studio Code Insiders (atualizações noturnas). Se você estiver usando a versão Insiders, tente instalar o build estável.
  3. Verifique se a rede da sua empresa não está bloqueando a conexão.
    1. Se você receber erros como connect EACCES, connect ECONNREFUSED, getaddrinfo ENOTFOUND ou outros erros semelhantes, seu firewall provavelmente está bloqueando as conexões ao nosso serviço de conexão. Para verificar isso, acesse este URL. Se a solicitação falhar ou você não visualizar nenhum dado, provavelmente precisará trabalhar com o administrador do sistema para adicionar *.visualstudio.com à lista de permissões de IP do firewall.
    2. Se você receber o erro Tunnel service HTTPS certificate is invalid. This may be caused by the use of a self-signed certificate or a firewall intercepting the connection, é provável que seu firewall esteja fazendo a inspeção TLS e injetando um certificado autoassinado no qual o GitHub não consegue verificar. Para resolver isso, o administrador do sistema precisará permitir que *.visualstudio.com ignore a inspeção ou instale a CA raiz que o firewall está injetando em seu computador local.

Se você ainda não conseguir conectar-se, talvez você precise entrar em contato com o suporte. Para obter mais informações, confira "Como trabalhar com o suporte para o GitHub Codespaces".

O codespace tem problemas de latência

Se o codespace parecer particularmente lento ou tiver problemas de latência, é possível que tenha sido criado em região distante de você. Para resolver isso, defina manualmente sua região do GitHub Codespaces.