Desarrolla código con un editor local de VS Code

Aprende a abrir un túnel SSH desde tu máquina local a una estación de trabajo y, luego, usa la asistencia de Desarrollo remoto de VS Code para conectarte a Cloud Workstations desde tu editor local de VS Code.

Sugerencia: Para una experiencia en el navegador, puedes usar Code OSS for Cloud Workstations del IDE de Cloud Workstations, que se basa en el proyecto de código abierto Code-OSS.

Antes de comenzar

Antes de comenzar, asegúrate de seguir los pasos necesarios para realizar estas tareas:

1. Asegúrate de que alguien de tu equipo haya creado una configuración de estación de trabajo.
2. Crea y, luego, inicia tu estación de trabajo.

3. Desde la consola de Google Cloud, copia la siguiente información:

   1. ID y nombre del proyecto: Haz clic en el nombre del proyecto en la barra de menú de Google Cloud y copia el ID en el cuadro de diálogo ID y nombre del proyecto que se abrirá.
   2. Región
   3. Nombre del clúster
   4. Nombre de la configuración

4. Desde tu máquina local, instala la CLI de gcloud.

   Si ejecutas la CLI de gcloud por primera vez, es posible que también debas ejecutar gcloud auth login para obtener credenciales y gcloud config set project PROJECT_ID para configurar tu proyecto actual con el ID del proyecto que copiaste en el paso anterior.

5. Cuando uses ssh por primera vez, instala una extensión SSH remota para que puedas conectarte a una estación de trabajo desde el editor de VS Code a través de Marketplace de extensiones o de la paleta de comandos.

   Marketplace de extensiones

   1. Abre tu aplicación local del editor de VS Code y, luego, selecciona
      Extensiones en la barra de actividad para abrir el Marketplace de extensiones.

   2. Haz clic en Instalar para instalar la extensión Remote - SSH.

   3. Ingresa remote ssh en el campo de búsqueda, que abre la página de la extensión para Remote - SSH.

      

   Paleta de comandos

   1. Para abrir la paleta de comandos, presiona Control + Mayúsculas + P (o Comando + Mayúsculas + P en macOS), o haz clic en Ver > Paleta de comandos.

   2. Ingresa ext install ms-vscode-remote.remote-ssh para instalar la extensión.

Abre un túnel SSH

Abre un túnel SSH desde tu máquina local a una estación de trabajo con el comando gcloud workstations start-tcp-tunnel:

1. En la consola de Google Cloud, ve a la página Cloud Workstations > Workstations.

   Ir a Estaciones de trabajo

2. Haz clic en el nombre de la estación de trabajo para abrir la página Detalles de la estación de trabajo.

3. En el siguiente ejemplo, reemplaza los marcadores de posición del nombre de la estación de trabajo, la región (ubicación), el nombre del clúster de la estación de trabajo y el nombre de la configuración de la estación de trabajo. Copia los valores del panel de detalles de la estación de trabajo en los marcadores de posición marcados con un ícono Editar (edit).

   gcloud workstations start-tcp-tunnel \
     --project=PROJECT_ID \
     --region=REGION \
     --cluster=CLUSTER_NAME \
     --config=CONFIG_NAME \
     --local-host-port=:LOCAL_PORT \
     WORKSTATION_NAME 22
   

   Consulta la sección Antes de comenzar para encontrar el ID del proyecto.

   La marca --local-host-port=:LOCAL_PORT es opcional. Si deseas especificar un puerto local, reemplaza LOCAL_PORT por el número de puerto local que deseas usar. Si no especificas un puerto local, el sistema elige un puerto local arbitrario sin usar y genera un mensaje con el número de puerto para que sepas qué puerto local usa.

4. Después de completar los marcadores de posición, haz clic en content_copy Copiar muestra de código para copiar el comando gcloud de la CLI.

5. Pega el comando en la ventana de tu terminal local y presiona Intro para crear el túnel.

   Cuando el comando se ejecuta de forma correcta, aparece un mensaje Listening on port seguido del número de puerto local.

Para obtener más detalles sobre cada marca de configuración, consulta Túnel SSH o start-tcp-tunnel.

Conéctate a un host de Cloud Workstations

Sigue estos pasos para conectarte a un host de Cloud Workstations:

1. Abre la aplicación de VS Code o regresa a ella.

2. Para iniciar Remote - SSH, haz clic en Abrir una ventana remota en la barra de estado.

   

3. Selecciona la opción Connect to Host cuando se abra la paleta de comandos.

   

4. Ingresa user@localhost:LOCAL_PORT y reemplaza LOCAL_PORT por el número de puerto local.

   En el siguiente ejemplo, se especifica user@localhost:1025 para conectar al puerto local 1025.

   

   Nota: Las claves de host para las estaciones de trabajo cambian entre sesiones porque las estaciones de trabajo se ejecutan en VM efímeras. Asegúrate de que la validación de la clave de host esté inhabilitada para la configuración de la estación de trabajo por este motivo.

5. Si se te solicita que te conectes después de que veas el mensaje de confirmación de Host agregado, haz clic en Conectar.

   El sistema también podría solicitarte que confirmes el hash. Si se te solicita, haz clic en Continuar.

6. Se abrirá un nuevo editor de VS Code, y en la barra de estado de VS Code se mostrará SSH: localhost: seguido del número de puerto.

   Ahora tienes acceso a los archivos y servidores de lenguajes de la estación de trabajo remota, y puedes compilar y ejecutar procesos que se ejecutan dentro de la estación de trabajo.

   En el siguiente ejemplo, se muestra una ventana del editor de VS Code conectada a Cloud Workstations a través de SSH: localhost: 1025.

   

   También puedes volver a Extensions Marketplace para instalar Cloud Code y otras extensiones locales de VS Code que te ayudarán a compilar, ejecutar y probar tu código.