Skip to main content

Solución de problemas de la conexión a GitHub Codespaces

Ayuda para resolver problemas para conectarse a GitHub Codespaces.

503 codespace service unavailable

Los codespaces están configurados para detenerse después de pasar 30 minutos sin actividad. Si intenta interactuar con un codespace después de que se haya detenido, es posible que vea un error 503 service unavailable.

  • Si se muestra un botón Iniciar en Visual Studio Code o en la ventana del explorador, haga clic en Iniciar para volver a conectarse al codespace.
  • Restablece tu codespace volviendo a cargar la ventana. Desde la paleta de comandos de Visual Studio Code, haz clic en Desarrollador: Volver a cargar Windows.

El buscador no se puede conectar

Es posible que en ocasiones no puedas acceder a un codespace desde tu buscador. Si esto sucede, vaya a https://github.com/codespaces e intente conectarse al codespace desde esa página.

  • Si el codespce no se lista en esa página, verifica que seas el propietario del codespace al cual intentas conectarte. Solo puedes abrir un codespace que tú mismo hayas creado.
  • Si el codespace se enlista pero no puedes conectarte desde esa página, revisa si puedes conectarte utilizando un buscador diferente.

Diagnóstico por mensaje de error

"Vaya, parece que está sin conexión"

Compruebe que tiene una conexión a internet estable y que la red de su empresa no bloquea la conexión. De ser posible, revise cualquier registro en bitácora para ver si hay conexiones rechazadas en el dispositivo.

Si ve conexiones rechazadas, asegúrese de que el servidor de seguridad no bloquea los dominios documentados por el punto de conexión de REST API /meta. Para más información, consulta Puntos de conexión de la API de REST para metadatos.

Para obtener la lista de dominios requeridos por GitHub Codespaces, ejecute el comando siguiente con GitHub CLI:

gh api meta | jq .domains.codespaces

"Tenemos problemas para capturar la información de codespace"

Se trata de un error transitorio. Espere unos minutos y vuelva a intentarlo.

"No hemos podido autenticar la conexión"

Esto indica que algo salió mal con la autenticación. Intente borrar el almacenamiento local y las cookies e inténtelo de nuevo.

Si todavía no puede conectarse y el mensaje que ve no está en esta lista, compruebe la disponibilidad de servicio de Codespaces en githubstatus.com. Si el servicio Codespaces está disponible, podrías necesitar contactar a soporte. Para obtener más información, vea «Trabajar con el soporte técnico de GitHub Codespaces».

No se puede conectar al codespace en JupyterLab

Para poder usar un codespace en JupyterLab, debes asegurarte de que el codespace lo tiene instalado. La imagen de contenedor de desarrolladores predeterminada que usa GitHub Codespaces incluye JupyterLab, pero si has personalizado la configuración del contenedor de desarrollo, tendrás que instalar manualmente JupyterLab.

Si el codespace usa una imagen basada en Debian, puedes instalar JupyterLab en el contenedor de desarrollo agregando la característica python al archivo devcontainer.json, con la opción installJupyterlab establecida en true. De lo contrario, instálalo directamente en el archivo Dockerfile. Para obtener instrucciones de instalación, consulta Instalación en la documentación de JupyterLab.

Para obtener más información sobre la característica python, consulta la página Léame en el repositorio devcontainers/features. Para más información sobre el archivo devcontainer.json y el Dockerfile, consulta Introducción a los contenedores dev.

Si aún no puedes conectarte, podrías necesitar contactar a soporte. Para obtener más información, vea «Trabajar con el soporte técnico de GitHub Codespaces».

La extensión de GitHub Codespaces para Visual Studio Code no puede conectarse

Si no puedes conectarte a un codespace desde la versión de escritorio de Visual Studio Code, utiliza los siguientes pasos de solución de problemas.

  1. Verifica que tengas instalada la última versión de GitHub Codespaces. La extensión es un lanzamiento de vista previa y se lanzan actualizaciones frecuentemente.
    1. En Visual Studio Code, muestra la pestaña de "Extensiones".
    2. Selecciona la extensión de GitHub Codespaces para mostrar la página de resumen de extensiones.
    3. Si hay una actualización disponible, se muestra un botón; haga clic en Actualizar a X.X.X para actualizar a la versión más reciente.
  2. Compruebe si usa la compilación estable de Visual Studio Code o la versión Visual Studio Code Insiders (actualizaciones nocturnas). Si usa la versión Insiders, pruebe a instalar la compilación estable.
  3. Asegúrese de que la red de la empresa no bloquea la conexión.
    1. Si recibe errores como connect EACCES, connect ECONNREFUSED, getaddrinfo ENOTFOUND u otros errores similares, es probable que el servidor de seguridad bloquee las conexiones a nuestro servicio de conexión. Para comprobarlo, visite esta dirección URL. Si se produce un error en la solicitud o no ve ningún dato, es probable que tenga que trabajar con el administrador del sistema para agregar *.visualstudio.com a la lista de IP permitidas del servidor de seguridad.
    2. Si ve el error Tunnel service HTTPS certificate is invalid. This may be caused by the use of a self-signed certificate or a firewall intercepting the connection , es probable que el servidor de seguridad realice la inspección de TLS e inserte un certificado autofirmado que GitHub no pueda verificar. Para resolver esto, el administrador del sistema deberá permitir *.visualstudio.com para omitir la inspección o instalar la CA raíz que el servidor de seguridad está insertando en el equipo local.

Si aún no puedes conectarte, podrías necesitar contactar a soporte. Para obtener más información, vea «Trabajar con el soporte técnico de GitHub Codespaces».

El codespace tiene problemas de latencia

Si el codespace se ve particularmente lento o tiene problemas de latencia, es posible que se haya creado en una región lejos de ti. Para resolverlo, puede establecer manualmente la región de GitHub Codespaces.