Aprende a abrir un túnel SSH desde tu máquina local a una estación de trabajo y, luego, usar Desarrollo remoto de VS Code para conectarte a Cloud Workstations desde tu editor local de VS Code.
Antes de comenzar
Antes de comenzar, asegúrate de seguir los pasos para estas tareas:
- Asegúrate de que un miembro de tu equipo haya creado una configuración de la estación de trabajo.
- Crea y, luego, inicia tu estación de trabajo.
En la consola de Google Cloud, copia la siguiente información:
- ID y nombre del proyecto: Haz clic en el nombre del proyecto en Google Cloud de la barra de menú y copia el ID en el diálogo Project name and ID que se abre.
- Región
- Nombre del clúster
- Nombre de la configuración
En tu máquina local, instala la CLI de
gcloud
.Si ejecutas la CLI de
gcloud
por primera vez, es posible que también necesites ejecutargcloud auth login
para obtener credenciales ygcloud config set project PROJECT_ID
para establecer tu proyecto actual en el ID de proyecto que copiaste en el paso anterior.Cuando uses
ssh
por primera vez, instala una extensión remota SSH para puedes conectarte a una estación de trabajo desde el editor de VS Code a través del Marketplace de la extensión o a través de la paleta de comandos.Marketplace de extensiones
Abre la aplicación local del editor de VS Code y, luego, la Selecciona la opción Marketplace de la extensión
. Extensiones en la barra de actividad.Haz clic en Instalar para instalar la extensión Remote - SSH.
Ingresa
remote ssh
en el campo de búsqueda, se abrirá la página de la extensión. para Remote-SSH.
Paleta de comandos
Para abrir la paleta de comandos, presiona Control + Mayúsculas + P (o Comando + Mayúsculas + P en macOS) o haz clic en Vista > Paleta de comandos.
Ingresa
ext install ms-vscode-remote.remote-ssh
para instalar el .
Abre un túnel SSH
Abre un túnel SSH desde tu máquina local hacia una estación de trabajo con el
gcloud workstations start-tcp-tunnel
:
En la consola de Google Cloud, ve a la página Cloud Workstations > Workstations.
Haz clic en el nombre de la estación de trabajo para abrir la página Detalles de la estación de trabajo.
En el siguiente ejemplo, reemplaza 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 de los detalles de la estación de trabajo en los marcadores de posición marcados con un 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 quieres especificar un puerto local, reemplazaLOCAL_PORT
por el número de puerto local que deseas usar. Si no especificas un puerto local, el sistema elige uno arbitrario que no se usa y muestra un mensaje con el número de puerto para que sepas cuál usa.Después de completar los marcadores de posición, haz clic en content_copy Copia la muestra de código para copiar el comando
gcloud
de la CLI.Pega el comando en la ventana de terminal local y presiona Intro. para crear el túnel.
Cuando el comando se ejecute de forma correcta, aparecerá un mensaje
Listening on port
seguido de el número de puerto local.
Para obtener más detalles sobre cada marca de configuración, consulta
Túnel SSH
o
start-tcp-tunnel
Cómo conectarse a un host de Cloud Workstations
Sigue estos pasos para conectarte a un host de Cloud Workstations:
- Abre la aplicación de VS Code o regresa a ella.
Para iniciar Remote-SSH, haz clic en Abre una ventana remota en la barra de estado.
Cuando se abra la paleta de comandos, selecciona la opción Conectarse al host.
Ingresa
user@localhost:LOCAL_PORT
, en reemplazoLOCAL_PORT
por el número de puerto localEn el siguiente ejemplo, se establece la conexión al puerto local
1025
especificandouser@localhost:1025
Si se te solicita conectarte después de ver la confirmación Host agregado haz clic en Conectar.
Es posible que el sistema también te solicite confirmar el hash. Si se te solicita, haz clic en Continuar.
Se abrirá un nuevo editor de VS Code y se mostrará la barra de estado de VS Code SSH: localhost: seguido del número de puerto
Ahora tienes acceso a los archivos y servidores de idioma de tu estación de trabajo remota, y puedes compilar y ejecutar procesos que se ejecutan dentro de ella.
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 Marketplace de Extensiones para instalar Cloud Code y otras extensiones locales de VS Code para ayudarte compilar, ejecutar y probar tu código.