Desarrolla código con los IDE de JetBrains locales

El complemento de Cloud Workstations te permite iniciar sesiones de desarrollo remoto para Cloud Workstations mediante 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 es compatible con la última versión y una versión anterior de los IDE de JetBrains y la puerta de enlace de JetBrains. Cuando se lanza una nueva versión principal del IDE de JetBrains, la siguiente actualización del complemento de Cloud Workstations admite la versión nueva y deja de admitir la versión más antigua compatible.

Nota: La compatibilidad del complemento de Cloud Workstations para el Programa de acceso anticipado de JetBrains (EAP) se basa en el mejor esfuerzo. A veces, el EAP presenta cambios rotundos, que pueden tardar un poco en abordarse.

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 del 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 solicite la Configuración, elige la imagen que corresponda al IDE de JetBrains que quieras usar.

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

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

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

Instala el complemento de Cloud Workstations

Nota: Si eres un usuario BYOID, ve a la sección Instrucciones de conexión alternativa para usuarios BYOID.

1. Instala el complemento de Cloud Workstations:

   1. Abre la puerta de enlace de JetBrains.

   2. Selecciona Todos los proveedores.

   3. En la sección Instalar más proveedores, busca Google Cloud y, luego, haz clic en Instalar para descargar el complemento de Cloud Workstations.

      

2. Después de la instalación, Cloud Workstations aparecerá en la sección Ejecuta el IDE de forma remota.

Conéctate con el complemento de Cloud Workstations

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

1. Abre la puerta de enlace de JetBrains.

2. En la sección Ejecuta el IDE de forma remota, haz clic en Conectar a Google Cloud.

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

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

   2. Haz clic en Continuar para completar el acceso.

4. Haz clic en Browse para abrir un diálogo del selector de proyectos y selecciona un proyecto de la nube.

   

5. Selecciona una estación de trabajo en el proyecto de la nube, 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 al proyecto del IDE en el host remoto.

      

   Nota: Recuerda que solo se conservan entre sesiones los archivos almacenados en el directorio /home.

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

Vuelve a conectarte a una estación de trabajo

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

1. Abre el panel reciente Conexiones.

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

   

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

Usa la redirección de puertos

Después de que el cliente de JetBrains se abra con tu IDE y proyecto, te recomendamos acceder 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, la puerta de enlace de JetBrains realiza la redirección de puertos automáticamente para que puedas acceder a los proyectos que se ejecutan de forma remota a través de tu navegador local.

También puedes redireccionar de forma manual los puertos de 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 Herramientas > Redirección de puertos y agrega una regla nueva a fin de reenviar TCP para el puerto 8080.

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

Anular extremos de 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. Sigue estos pasos para anular los extremos de la API:

1. En Windows y Linux, haz clic en settings menú Opciones > Configuración.

   

   En macOS, haz clic en settings Menú de opciones > Preferencias.

   

2. Opcional: Si quieres acceder a la Configuración de JetBrains para IntelliJ y otros IDE, consulta cómo definir la configuración del proyecto.

3. Ve a Tools > Google Cloud Workstations > Advanced.

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

   Nota: Asegúrate de usar los nombres de DNS de p.googleapis.com de la nube privada virtual. No uses direcciones IP.

   

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 cómo acceder a las API de Google a través de extremos.

Instrucciones de conexión alternativa para usuarios BYOID

Si usas BYOID, debes realizar pasos adicionales para conectarte con la puerta de enlace de Jetbrains. Lleva a cabo los pasos siguientes:

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

Sigue estos pasos para iniciar tu estación de trabajo y abrir 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
   

Nota: Debes tener la CLI de gcloud versión 387.0.0 o posterior para que este comando sea compatible. Ejecuta el comando gcloud version para verificar la versión de la CLI de gcloud. Si es necesario, realiza la actualización con el comando gcloud components update.

Una vez completadas la configuración y la instalación iniciales, el siguiente paso es iniciar la puerta de enlace de Jetbrains.

Inicia la puerta de enlace Jetbrains

1. Después de iniciar la puerta de enlace de Jetbrains, selecciona Conectar a través de SSH.

2. En la página Conectarse a SSH, haz clic en Configuración para configurar una conexión nueva.

   Desde la página Configuración de SSH:

   1. Haz clic en addAgregar nueva conexión (Add a new connection).
   2. Ingresa la información de tu conexión. Por ejemplo, Local Host=127.0.0.1, Port=2222 y Username=user. Asegúrate de usar valores adecuados para tu configuración del host local, el puerto y el nombre de usuario.
   3. Configura el Tipo de autenticación como Contraseña y deja el campo de la contraseña en blanco.
   4. Borra la opción del archivo de configuración de Parse ~/.ssh/config.
   5. Haz clic en Aceptar para crear la conexión.
   6. Haz clic en Check Connection and Continue.

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 Abrir una terminal SSH y ejecuta comandos a fin de crear un directorio para tu proyecto de JetBrains.

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

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

   3. Después de seleccionar el directorio del proyecto, haz clic en Download and Start IDE.

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