Skip to main content
Publicamos actualizaciones para la documentación con frecuencia y es posible que aún se esté traduciendo esta página. Para obtener la información más reciente, consulta la documentación en inglés.

Uso de GitHub Codespaces en el IDE de JetBrains

Puedes usar la puerta de enlace de JetBrains para conectarte al codespace y trabajar en tu IDE de JetBrains favorito.

Nota: El uso de GitHub Codespaces con un IDE de JetBrains se encuentra actualmente en versión beta pública y está sujeto a cambios.

Acerca del Codespaces en IDE de JetBrains

Si usas un IDE de JetBrains para trabajar en el código, puedes aprovechar las ventajas de trabajar en un codespace. Para ello, usa la aplicación de puerta de enlace de JetBrains.

Después de instalar la puerta de enlace de JetBrains, puedes establecer JetBrains como editor predeterminado y, después, siempre que abras un codespace desde GitHub.com se iniciará la puerta de enlace de JetBrains para permitirte elegir el IDE de JetBrains y conectarse al codespace.

Nota: Solo los codespaces existentes están disponibles en la puerta de enlace de JetBrains. Puedes crear codespaces en GitHub.com o utilizando la GitHub CLI. Para obtener más información, consulta "Creación de un codespace para un repositorio".

Proceso de conexión de desarrollo remoto de JetBrains

El proceso básico que hay detrás del uso de un codespace en el IDE de JetBrains es el siguiente.

  • En la aplicación de puerta de enlace de JetBrains, selecciona uno de los codespaces activos o detenidos.
  • Después, elige el IDE de JetBrains que quieras usar.
  • Luego, el IDE de JetBrains seleccionado se descarga en la máquina virtual remota que hospeda el codespace y el código fuente.
  • La aplicación cliente ligera de JetBrains se descarga en el equipo local y se inicia.
  • La aplicación cliente se conecta al IDE de back-end completo.
  • Puedes trabajar en el código de la aplicación cliente de la misma manera que lo harías en un entorno local.

Requisitos previos

Para trabajar en un codespace en un IDE de JetBrains, necesitas lo siguiente:

  • Una licencia válida de JetBrains
  • La aplicación de puerta de enlace de JetBrains
  • GitHub CLI, versión 2.18.0 o posterior
  • Un codespace existente que ejecute un servidor SSH

Licencia de JetBrains

Debes tener una licencia para al menos uno de los IDE de JetBrains admitidos a fin de conectarse a un codespace desde la puerta de enlace de JetBrains.

Puerta de enlace de JetBrains

Puedes instalar y actualizar la puerta de enlace de JetBrains desde la aplicación de Cuadro de herramientas de JetBrains.

  1. Descarga e instala el Cuadro de herramientas de JetBrains.

  2. Abre el Cuadro de herramientas de JetBrains.

  3. Busca Puerta de enlace en la lista de herramientas disponibles y haz clic en Instalar.

    Captura de pantalla del Cuadro de herramientas de JetBrains

GitHub CLI

El complemento GitHub Codespaces para la puerta de enlace de JetBrains requiere que hayas instalado y configurado la GitHub CLI, versión 2.18.0 o posterior, antes de abrir un codespace desde la puerta de enlace de JetBrains.

Usa este comando para comprobar la versión de la GitHub CLI:

Shell
gh --version

Para obtener más información, consulta "Acerca de la CLI de GitHub".

Codespace que ejecuta un servidor SSH

Debes tener un codespace existente al que conectarse. Puedes crear un codespace en GitHub.com, en Visual Studio Code o utilizando el GitHub CLI. Para obtener más información, consulta "Creación de un codespace para un repositorio".

El codespace al que te conectes debe ejecutar un servidor SSH. La imagen de contenedor predeterminada incluye un servidor SSH, que se inicia automáticamente. Si los codespaces no se crean a partir de la imagen predeterminada, puedes instalar e iniciar un servidor SSH agregando lo siguiente al objeto features en el archivo devcontainer.json.

"features": {
    ...
    "ghcr.io/devcontainers/features/sshd:1": {
        "version": "latest"
    },
    ...
}

Para obtener más información sobre el archivo devcontainer.json y la imagen de contenedor predeterminada, consulta "Introducción a los contenedores de desarrollo".

Nota: Para obtener ayuda a fin de conectarse al codespace mediante SSH, consulta "Solución de problemas de clientes de GitHub Codespaces".

Configuración de la Puerta de enlace de JetBrains

La primera vez que uses la Puerta de enlace de JetBrains para GitHub Codespaces, debes instalar el complemento de Codespaces. También debes permitir que la Puerta de enlace de JetBrains acceda a GitHub.com mediante la cuenta de GitHub.

  1. Abre la aplicación de Puerta de enlace de JetBrains.

  2. En Instalar más proveedores, haz clic en el vínculo Instalar para GitHub Codespaces.

    Captura de pantalla de la vista inicial de la Puerta de enlace de JetBrains

  3. Haz clic en Conectar a codespace.

    Captura de pantalla de la Puerta de enlace con el botón "Conectar a Codespace"

  4. En el cuadro de diálogo "Bienvenido a la Puerta de enlace de JetBrains", haz clic en Iniciar sesión con GitHub .

    Captura de pantalla del botón de inicio de sesión

  5. Haz clic en el icono situado junto al código único para copiarlo y, después, en el vínculo de inicio de sesión.

    Captura de pantalla del código de inicio de sesión único

  6. Si no has iniciado sesión actualmente en GitHub, se muestra la página de inicio de sesión.

    • Escribe la información y haz clic en Iniciar sesión.
    • Comprueba la autenticación, por ejemplo, escribiendo un código de autenticación en dos fases.
  7. En la página "Activación del dispositivo", pega el código copiado y haz clic en Continuar.

  8. Si perteneces a organizaciones, se muestra la página "Inicio de sesión único en tus organizaciones". Haz clic en Autorizar junto a las organizaciones a las que quieres autorizar el acceso a la Puerta de enlace de JetBrains y, después, haz clic en Continuar.

  9. En la página "Autorizar GitHub Codespaces para JetBrains", haz clic en Autorizar GitHub .

  10. Vuelve a la aplicación de Puerta de enlace de JetBrains y abre un codespace de la lista de codespaces activos o detenidos actualmente; consulta el paso 3 del procedimiento siguiente.

Apertura de un codespace en el IDE de JetBrains

Si has establecido la puerta de enlace de JetBrains como editor predeterminado, la puerta de enlace se iniciará automáticamente al abrir un espacio de código desde GitHub.com.

Si la puerta de enlace de JetBrains no es el editor predeterminado, todavía puedes abrir un codespace en JetBrains; para ello, ve a la página "Sus codespaces" en github.com/codespaces y haz clic en los puntos suspensivos (...) a la derecha del espacio de código que quieres abrir. Para obtener más información, consulta "Apertura de un espacio de código existente".

Como alternativa, también puedes abrir la puerta de enlace de JetBrains y seleccionar un espacio de código existente, como se describe en el procedimiento siguiente.

  1. Abre la aplicación de Puerta de enlace de JetBrains.

  2. Haz clic en Conectar con Codespaces .

    Captura de pantalla de la vista inicial de la Puerta de enlace de JetBrains

  3. En la lista "Your Codespaces", haz clic en el codespace en el que quieres trabajar.

    Captura de pantalla de la lista de codespaces de puerta de enlace de JetBrains

  4. En la lista "IDE disponibles", haz clic en el IDE de JetBrains que quieres usar. La puerta de enlace recordará tu elección la próxima vez que te conectes a un codespace.

    Captura de pantalla de la lista de codespaces de puerta de enlace de JetBrains

  5. Haga clic en Conectar.

    Nota: Si ejecuta un firewall: la primera vez que te conectas a un recurso remoto, es posible que se te pida que permitas que la puerta de enlace de JetBrains se comunique a través de la red.

    La primera vez que te conectes a un codespace, el IDE de back-end se descargará en la máquina remota. Esta operación puede tardar unos minutos. La próxima vez que te conectes al mismo codespace, este paso no será necesario, lo que hace que el proceso de conexión sea más rápido.

    Después, se inicia el IDE de back-end. De nuevo, este paso no será necesario en el futuro si vuelves a conectarte a un IDE de back-end que hayas dejado en ejecución.

    Luego, se inicia la aplicación cliente.

Información adicional