Cómo desarrollar código con los IDE de JetBrains locales

El complemento de Cloud Workstations te permite iniciar sesiones de desarrollo remoto para Cloud Workstations que usan IDE de JetBrains, como IntelliJ IDEA Ultimate y 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 anterior versión de IDE de JetBrains y Puerta de enlace de JetBrains. 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.

Nota: La compatibilidad del complemento de Cloud Workstations para la Programa de acceso anticipado a JetBrains (EAP) se basa en el mejor esfuerzo. A veces, el EAP introduce cambios drásticos, y estos pueden tardar un tiempo 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 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 Configuration, elige la imagen que corresponda al IDE de JetBrains. que quieres usar.

2. Luego 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 terminar de crear.

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 de BYOID, ve a la sección Instrucciones de conexión alternativa para usuarios de BYOID.

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.

      

2. Después de la instalación, Cloud Workstations aparecerá en 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 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.

   

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 de IDE en el host remoto.

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

      

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

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 con rapidez 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 acceso de un 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 se abra el cliente de JetBrains con tu IDE y proyecto, recomendamos que hagas lo siguiente: acceder a los puertos remotos de 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 el reenvío 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 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. Luego de establecer esta regla, podrás 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 extremos de API.

   Nota: Asegúrate de usar la nube privada virtual p.googleapis.com nombres de DNS. 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 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 realizar pasos adicionales para conectarte con Jetbrains. Puerta de enlace. Lleva a cabo los pasos siguientes:

Inicia la 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 se esté ejecutando. Puedes usar los siguientes gcloud para iniciarla.

   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 versión 387.0.0 de la CLI de gcloud o posterior para esta que se admita. Para verificar tu versión de la CLI de gcloud, ejecuta el comando Comando gcloud version. Si es necesario, actualízalo con el comando gcloud components update.

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

Inicia la puerta de enlace de Jetbrains

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

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

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

   1. Haz clic en addAdd a new connection.
   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ú. Puedes Solo 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 en tus estaciones de trabajo. Por ejemplo, los siguientes el comando clona el proyecto de Cloud Code Samples en tu página principal directorio:

      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 Extensión de Cloud Workstations para ayudarte a compilar y ejecutar tu código.