Desarrollar código con un editor de VS Code local

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

Antes de empezar

Antes de empezar, asegúrate de seguir los pasos de estas tareas:

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

  3. Mientras estés en la Google Cloud consola, copia la siguiente información:

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

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

    Si ejecutas la CLI de gcloud por primera vez, es posible que también tengas que ejecutar gcloud auth login para obtener las credenciales y gcloud config set project PROJECT_ID para definir el proyecto actual como el ID de proyecto que has copiado en el paso anterior.

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

    Extension Marketplace

    1. Abre la aplicación local del editor VS Code y, a continuación, abre Extension Marketplace seleccionando
      Extensiones en la barra de actividad.

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

    3. Escribe remote ssh en el campo de búsqueda para abrir la página de la extensión Remote - SSH.

      Instalar la extensión Remote - SSH

    Paleta de comandos

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

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

Abrir 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 Google Cloud consola, ve a la página Cloud Workstations > Estaciones de trabajo.

    Ve a Puestos 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, sustituye los marcadores de posición por el 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 Detalles de la estación de trabajo en los marcadores de posición que tienen el icono de editar.

    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 empezar para encontrar el ID del proyecto.

    La marca --local-host-port=:LOCAL_PORT es opcional. Si quieres especificar un puerto local, sustituye LOCAL_PORT por el número de puerto local que quieras usar. Si no especificas un puerto local, el sistema elegirá un puerto local arbitrario que no se esté usando y mostrará un mensaje con el número de puerto para que sepas cuál utiliza.

  4. Después de rellenar los marcadores de posición, haz clic en content_copy Copiar código de ejemplo para copiar el comando de la interfaz de línea de comandos gcloud.

  5. Pega el comando en la ventana del terminal local y pulsa Intro para crear el túnel.

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

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

Conectarse a un host de Cloud Workstations

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

  1. Abre o vuelve a la aplicación VS Code.

  2. Para iniciar Remote - SSH (Remoto - SSH), haz clic en Open a Remote Window (Abrir una ventana remota) en la barra de estado.

  3. Selecciona la opción Conectar con el host cuando se abra la paleta de comandos.

    Conectar con el host

  4. Introduce user@localhost:LOCAL_PORT y sustituye LOCAL_PORT por el número de tu puerto local.

    En el siguiente ejemplo se conecta al puerto local 1025 especificando user@localhost:1025.

    Añadir host SSH

  5. Si se te pide que te conectes después de ver el mensaje de confirmación Host Added (Host añadido), haz clic en Connect (Conectar).

    El sistema también puede pedirte que confirmes el hash. Si se te pide, haz clic en Continuar.

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

    Ahora tienes acceso a los archivos y servidores de idiomas de tu estación de trabajo remota, y puedes compilar y ejecutar procesos que se ejecuten en tu estación de trabajo.

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

    Conectado a la estación de trabajo

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