Desarrollar código con IDEs de JetBrains locales

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

Sistemas operativos compatibles

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

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

Versiones compatibles

El complemento Cloud Workstations es compatible con la versión más reciente y con la anterior de los IDEs de JetBrains y de JetBrains Gateway. Cuando se lanza una nueva versión principal de un IDE de JetBrains, la siguiente versión del complemento de Cloud Workstations es compatible con la nueva versión y deja de ser compatible con la versión más antigua que se admitía anteriormente.

Nota: La asistencia del complemento Cloud Workstations para el programa de acceso anticipado de JetBrains (EAP) se ofrece de la mejor manera posible. A veces, el programa de acceso anticipado introduce cambios que provocan errores y puede que tardemos en solucionarlos.

Para que te resulte más fácil mantener actualizadas las aplicaciones de JetBrains, también puedes instalar JetBrains Toolbox.

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

Antes de empezar

Sigue estos pasos antes de instalar el complemento Cloud Workstations:

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

2. Después de introducir 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 se termine de crear la estación de trabajo.

4. Descarga e instala una versión compatible de JetBrains Gateway.

Añadir una comprobación de disponibilidad del servidor

Para mayor comodidad, todas las imágenes de JetBrains vienen con un servidor HTTP básico preinstalado que se ejecuta en el puerto 80 y que se puede usar para determinar si el IDE de JetBrains preconfigurado está listo para aceptar conexiones entrantes. Te recomendamos que añadas una comprobación de disponibilidad HTTP en el puerto 80 de la configuración de tu estación de trabajo. Con esta comprobación, las estaciones de trabajo aparecen en la consola Google Cloud como RUNNING solo cuando el IDE está listo. Por lo tanto, JetBrains Gateway esperará hasta que el IDE esté listo antes de intentar conectarse.

Instalar el complemento Cloud Workstations

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

1. Instala el complemento Cloud Workstations:

   1. Abre JetBrains Gateway.

   2. Selecciona Todos los proveedores.

   3. En la sección Install More Providers (Instalar más proveedores), busca Google Cloud y, a continuación, haz clic en Install (Instalar) para descargar el complemento Cloud Workstations.

      

2. Después de la instalación, Cloud Workstations aparece en la sección Ejecutar el IDE de forma remota.

Conectarse mediante el complemento Cloud Workstations

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

1. Abre JetBrains Gateway.

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

3. Haz clic en Iniciar sesión para iniciar sesión en tu cuenta de Google.

   1. Sigue las instrucciones para conceder acceso al complemento Cloud Workstations a Google Cloud.

   2. Haz clic en Continuar para completar el inicio de sesión.

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

   

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

6. Selecciona tu IDE y tu proyecto:

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

   2. Introduce una ruta de proyecto de IDE en el host remoto.

      

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

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

Volver a conectarse a una estación de trabajo

Para volver a conectarte rápidamente a una estación de trabajo y a un proyecto de IDE, sigue estos pasos:

1. Abre el panel Conexiones recientes.

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

   

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

Usar la redirección de puertos

Una vez que se abra el cliente de JetBrains con tu IDE y tu proyecto, es posible que quieras acceder a los puertos remotos de Cloud Workstations desde tu máquina local. Por ejemplo, si ejecutas un servidor Python en la estación de trabajo, python -m SimpleHTTPServer 8080. En algunos casos, JetBrains Gateway reenvía los 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 reenviar puertos manualmente desde Cloud Workstations a tu máquina local de la siguiente manera:

1. En Windows y Linux, selecciona Archivo > Configuración en el menú principal.

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

2. Ve a Herramientas > Reenvío de puertos y añade una regla para reenviar el protocolo TCP del puerto 8080.

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

Anular los endpoints de la API

Si usas una nube privada virtual y necesitas anular los endpoints de la API, asegúrate de que el complemento pueda conectarse a tus servicios en la nube. Para anular los endpoints 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 los ajustes de JetBrains en IntelliJ y otros IDEs, consulta cómo configurar los ajustes del proyecto.

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

4. Añade URLs de sustitución de endpoints de API.

   Nota: Asegúrate de usar nombres de DNS de p.googleapis.comnube privada virtual. No uses direcciones IP.

   

5. Haz clic en Aplicar.

Para obtener más información sobre el uso de endpoints en Google Cloud, consulta la descripción de Virtual Private Cloud sobre cómo acceder a las APIs de Google a través de endpoints.

Instrucciones de conexión alternativas para usuarios de BYOID

Si usas BYOID, debes seguir algunos pasos adicionales para conectarte con Jetbrains Gateway. Sigue estos pasos:

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 empezar.

2. Asegúrate de que tu estación de trabajo esté en funcionamiento. Puedes usar el siguiente comando de la CLI 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: Para que se admita este comando, debes tener la versión 387.0.0 o una posterior de la CLI de gcloud. Comprueba la versión de la CLI de gcloud ejecutando el comando gcloud version. Si es necesario, actualiza la información con el comando gcloud components update

.

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

Iniciar Jetbrains Gateway

1. Después de iniciar Jetbrains Gateway, selecciona Conectar mediante SSH.

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

   En la página Configuración de SSH:

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

3. En la página Choose IDE and Project (Elegir IDE y proyecto), selecciona lo siguiente:

   1. Selecciona el IDE que quieras usar.

   2. Selecciona el directorio que contiene tu proyecto haciendo clic en more_horiz Más. Ten en cuenta que no puedes crear un proyecto desde este menú. Solo puedes abrir un proyecto. Para crear un proyecto, selecciona Abrir un terminal SSH y ejecuta comandos para crear un directorio para tu proyecto de JetBrains.

      También puedes hacer clic en Abrir un terminal SSH para ejecutar comandos de git en tus estaciones de trabajo. Por ejemplo, el siguiente comando clona el proyecto Cloud Code Samples 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 e iniciar IDE.

4. Una vez que el IDE se haya conectado, 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 Cloud Workstations para ayudarte a compilar y ejecutar tu código.