Desarrolla código con los IDE de JetBrains locales

El complemento de Cloud Workstations te permite iniciar sesiones de desarrollo remoto para Cloud Workstations con los IDE de JetBrains, como IntelliJ IDEA Ultimate, PyCharm Professional, Rider, CLion, PhpStorm y WebStorm.

Sistemas operativos compatibles

El complemento de Cloud Workstations es compatible con los siguientes sistemas operativos:

  • Windows
  • macOS (Intel y Apple Silicon)
  • Linux

Versiones compatibles

El complemento de Cloud Workstations admite la versión más reciente y una versión anterior de los IDE de JetBrains y JetBrains Gateway. Cuando se lanza una nueva versión principal del IDE de JetBrains, la siguiente versión del complemento de Cloud Workstations admite la nueva versión y deja de admitir la versión anterior compatible.

Para facilitar la actualización de las apps de JetBrains, también puedes instalar JetBrains Toolbox.

Para obtener más información sobre las versiones de IDE de JetBrains en imágenes base preconfiguradas, consulta las notas de la versión de Cloud Workstations.

Antes de comenzar

Asegúrate de seguir estos pasos antes de instalar el complemento de Cloud Workstations:

  1. Sigue los pasos para crear una estación de trabajo. Cuando se te solicite la configuración, elige la imagen que corresponda al IDE de JetBrains que deseas usar.

  2. Después de ingresar el nombre de la estación de trabajo, haz clic en Crear.

  3. Haz clic en la página Estaciones de trabajo y espera a que se termine de crear la estación de trabajo.

  4. Descarga e instala una versión compatible de la puerta de enlace de JetBrains.

Instala el complemento de Cloud Workstations

  1. Instala el complemento de Cloud Workstations:

    1. Abre JetBrains Gateway.

    2. Selecciona Todos los proveedores.

    3. En la sección Install More Providers, busca Google Cloud y, luego, haz clic en Install para descargar el complemento Cloud Workstations.

      Cómo conectarse a Cloud Workstations

  2. Después de la instalación, Cloud Workstations aparecerá en la sección Run the IDE Remotely.

Conéctate con el complemento de Cloud Workstations

Para conectarte a una estación de trabajo con el complemento, sigue estos pasos:

  1. Abre JetBrains Gateway.

  2. En la sección Run the IDE Remotely, haz clic en Connect to Google Cloud.

  3. Haz clic en Acceder para ingresar a tu Cuenta de Google.

    1. Sigue las indicaciones para otorgarle acceso a Google Cloud al complemento de Cloud Workstations.

    2. Haz clic en Continuar para completar el acceso.

  4. Haz clic en Explorar para abrir un diálogo del selector de proyectos y seleccionar un proyecto de Cloud.

    Cómo conectarse a Cloud Workstations

  5. Selecciona una estación de trabajo en el proyecto de Cloud, haz clic en Siguiente y espera a que se inicie la estación de trabajo seleccionada.

  6. Selecciona tu IDE y proyecto:

    1. Selecciona una versión del IDE en el host remoto.

    2. Ingresa una ruta de acceso de proyecto de IDE en el host remoto.

      Selecciona tu IDE y, luego, ingresa el nombre de tu proyecto.

  7. Haz clic en Connect y espera a que se abran el IDE y el proyecto.

Cómo volver a conectarte a una estación de trabajo

Para volver a conectarte rápidamente a una estación de trabajo y a un proyecto de IDE, haz lo siguiente:

  1. Abre el panel Conexiones recientes.

  2. Haz clic en la ruta de acceso de un proyecto para abrir un IDE en Cloud Workstations.

    Lista de estaciones de trabajo usadas recientemente

  3. Espera a que se abran el IDE y el proyecto.

Usa la redirección de puertos

Después de que se abra el cliente de JetBrains con tu IDE y proyecto, te recomendamos que accedas a los puertos remotos en Cloud Workstations desde tu máquina local. Por ejemplo, cuando ejecutas un servidor de Python en la estación de trabajo, python -m SimpleHTTPServer 8080. En algunos casos, JetBrains Gateway realiza automáticamente el reenvío de puertos para que puedas acceder a los proyectos que se ejecutan de forma remota a través de tu navegador local.

También puedes reenviar puertos de forma manual desde Cloud Workstations a tu máquina local de la siguiente manera:

  1. En Windows y Linux, selecciona File > Settings en el menú principal.

    En macOS, selecciona IntelliJ IDEA > Preferences en el menú principal.

  2. Ve a Tools > Port Forwarding y agrega una regla nueva para reenviar TCP al puerto 8080.

  3. Después de configurar esta regla, puedes acceder al puerto 8080 de Cloud Workstations de forma local en http://localhost:8080.

Anula los extremos de la API

En el caso de los usuarios de la nube privada virtual que necesiten anular los extremos de la API, asegúrate de que el complemento pueda conectarse a tus servicios en la nube. Para anular los extremos de la API, sigue estos pasos:

  1. En Windows y Linux, haz clic en Configuración Menú de opciones > Configuración.

    En macOS, haz clic en Configuración Menú de opciones > Preferencias.

  2. Opcional: Para acceder a la configuración de JetBrains para IntelliJ y otros IDEs, consulta cómo configurar la configuración del proyecto.

  3. Ve a Herramientas > Google Cloud Workstations > Avanzado.

  4. Agrega URLs de anulación de extremo de API.

  5. Haz clic en Aplicar.

Para obtener más información sobre el uso de extremos en Google Cloud, consulta la descripción de la nube privada virtual sobre el acceso a las APIs de Google a través de extremos.

Instrucciones de conexión alternativas para usuarios de BYOID

Si usas BYOID, debes seguir pasos adicionales para conectarte con Jetbrains Gateway. Lleva a cabo los pasos siguientes:

Inicia tu estación de trabajo y abre una conexión TCP

En los siguientes pasos, se inicia la estación de trabajo y se abre una conexión TCP:

  1. Sigue las instrucciones de la sección Antes de comenzar.

  2. Asegúrate de que tu estación de trabajo esté en ejecución. Puedes usar el siguiente comando de la CLI de gcloud para iniciarlo.

    gcloud workstations start WORKSTATION_ID –-project=PROJECT \
  --cluster=WORKSTATION_CLUSTER_ID --config=WORKSTATION_CONFIG_ID \
  --region=WORKSTATION_CLUSTER_REGION

  3. Inicia un túnel TCP a tu estación de trabajo en el puerto 22:

    gcloud workstations start-tcp-tunnel --project=PROJECT \
    --cluster=WORKSTATION_CLUSTER_ID \
    --config=WORKSTATION_CONFIG_ID \
    --region=WORKSTATION_CLUSTER_REGION \
    WORKSTATION_ID 22 --local-host-port=127.0.0.1:2222

Una vez completada la configuración y la instalación iniciales, el siguiente paso es iniciar Jetbrains Gateway.

Cómo iniciar Jetbrains Gateway

  1. Después de iniciar Jetbrains Gateway, selecciona Connect via SSH.

  2. En la página Connect to SSH, haz clic en Settings para configurar una conexión nueva.

    En la página Configuración de SSH, haz lo siguiente:

    1. Haz clic en Agregar una conexión nueva.
    2. Ingresa tu información de conexión. Por ejemplo, Host local=127.0.0.1, Puerto=2222 y Nombre de usuario=user. Asegúrate de usar valores adecuados para tu configuración del host local, el puerto y el nombre de usuario.
    3. Establece el Tipo de autenticación en Contraseña y deja el campo de contraseña en blanco.
    4. Borra la opción Analizar el archivo de configuración ~/.ssh/config.
    5. Haz clic en Aceptar para crear la conexión.
    6. Haz clic en Verificar conexión y continuar.

  3. En la página Choose IDE and Project, selecciona lo siguiente:

    1. Selecciona el IDE que quieres usar.

    2. Haz clic en more_horiz Más para seleccionar el directorio que contiene tu proyecto. Ten en cuenta que no puedes crear un proyecto desde este menú. Solo puedes abrir un proyecto. Para crear un proyecto nuevo, selecciona Open an SSH Terminal y ejecuta comandos para crear un directorio para tu proyecto de JetBrains.

      Como alternativa, también puedes hacer clic en Open an SSH terminal para ejecutar comandos git dentro de tus estaciones de trabajo. Por ejemplo, el siguiente comando clona el proyecto de muestras de Cloud Code en tu directorio principal:

      git clone https://github.com/GoogleCloudPlatform/cloud-code-samples.git

    3. Después de seleccionar el directorio del proyecto, haz clic en Descargar y iniciar IDE.

  4. Después de que se conecte el IDE, podrás acceder a los archivos de tu estación de trabajo directamente desde tu IDE de JetBrains, que también puede usar la extensión de Cloud Workstations para compilar y ejecutar tu código.