De forma predeterminada, puedes conectarte a los puertos HTTP 80 y a los puertos 1024 a 65535 en tus
estaciones de trabajo desde tu navegador. Puedes restringir los puertos a los que puedes conectarte en
tus estaciones de trabajo configurando allowedPorts
en la configuración de la estación de trabajo.
Las estaciones de trabajo en ejecución tienen una propiedad host que puedes usar
para conectarte con HTTP desde un navegador remoto. Puedes encontrar la propiedad host
obteniendo detalles de una estación de trabajo en ejecución a través de la API, Google Cloud CLI,
la consola de Google Cloud o imprimiendo la variable de entorno $WEB_HOST,
que se configura automáticamente dentro de tu estación de trabajo.
La URL se conecta al puerto 80 de forma predeterminada.
Formato de URL predeterminado de la estación de trabajo
La URL de la propiedad host usa el siguiente formato de forma predeterminada:
https://PORT-WORKSTATION_NAME.CLUSTER_ID.cloudworkstations.dev
Los marcadores de posición representan lo siguiente:
PORT: Es el número de puerto, que es el puerto80de forma predeterminada.WORKSTATION_NAME: Es el nombre de la estación de trabajo.CLUSTER_ID: Es el identificador del clúster generado de forma aleatoria.cloudworkstations.dev: Es el nombre de dominio predeterminado para una estación de trabajo.Las URLs de los dominios personalizados usan un formato diferente. Para obtener más información sobre la configuración de dominios personalizados en Cloud Workstations, consulta Configura dominios personalizados para Cloud Workstations.
Conéctate a un puerto diferente cambiando la URL
Para conectarte a un puerto diferente, especifica un número de puerto diferente como
prefijo. Por ejemplo, la siguiente URL se conecta al puerto 9900:
https://9900-myworkstation.cluster-12345abcde.cloudworkstations.dev
En este ejemplo, ten en cuenta lo siguiente:
9900: Representa el número de puerto.myworkstation: representa el ID de la estación de trabajo.cluster-12345abcde: representa el identificador del clúster.cloudworkstations.dev: Representa el nombre de dominio predeterminado para una estación de trabajo.
Estas URLs requieren la autenticación del usuario. Para abrir estas URLs,
debes estar conectado y tener el rol de IAM de usuario de Cloud Workstations, roles/workstations.user, o el permiso
workstations.workstations.use.
Si tu clúster de estaciones de trabajo está configurado con
puertos de acceso directo, en lugar de codificar el
puerto como un prefijo, puedes conectarte a un puerto configurado agregando
:PORT al nombre de host de la estación de trabajo.
Por ejemplo, después de configurar el puerto 9900 como un puerto de acceso directo, la
siguiente URL también se conecta al puerto 9900:
https://myworkstation.cluster-12345abcde.cloudworkstations.dev:9900
Conéctate a una app de HTTP desde la consola de Google Cloud
Puedes conectarte a una app de HTTP que se ejecute en una estación de trabajo desde la consola deGoogle Cloud .
Para cualquier estación de trabajo en ejecución que tengas permiso de usar, verás un botón Iniciar. De forma predeterminada, este botón se conecta al puerto 80. Puedes
hacer clic en la flecha de expansión arrow_drop_down
junto a Iniciar para ver opciones de conexión alternativas. La opción
Conéctate a la app web en el puerto te permite especificar un puerto diferente para
conectarte.
Conéctate a una app de HTTP desde el editor de bases
Para conectarte a una app que se ejecuta en tu estación de trabajo desde el editor base de Cloud Workstations, sigue cualquiera de estas instrucciones:
Haz clic en los vínculos de localhost en la terminal. El editor base redirecciona automáticamente los vínculos de localhost a las URLs correctas.
Para abrir una ventana de terminal, haz clic en menú Menú > Terminal > Nueva terminal. Como alternativa, presiona Control + Mayúsculas +` (o Comando + Mayúsculas +` en macOS).
En el símbolo del sistema, ejecuta el siguiente comando para mostrar el vínculo de localhost:
echo http://localhost:PORTReemplaza
PORTpor un número de puerto, como80o8080.Mantén presionada la tecla Control (o Comando en macOS) y, luego, haz clic en el vínculo de localhost.
Se abriráPORT-WORKSTATION_HOSTNAMEen tu navegador.
Usa la ventana del navegador: navega a
https://PORT-WORKSTATION_HOSTNAME, en el quePORTes el número de puerto yWORKSTATION_HOSTNAMEes el nombre de host de tu estación de trabajo.
Configura puertos de acceso directo
De forma predeterminada, cuando te conectas a un puerto de estación de trabajo codificando el puerto como un
prefijo en la URL, tu solicitud
se conecta a la puerta de enlace del clúster a través del puerto HTTPS 443, y la puerta de enlace reenvía
la solicitud a PORT en tu estación de trabajo.
Para conectarte directamente a un puerto de estación de trabajo con el formato de URL estándar de
https://WORKSTATION_NAME.CLUSTER_ID.cloudworkstations.dev:PORT,
debes configurar el puerto como un puerto de acceso directo en el
clúster de la estación de trabajo.
Para configurar puertos de acceso directo en un clúster de estaciones de trabajo existente, ejecuta el siguiente comando de Google Cloud CLI:
gcloud beta workstations clusters update CLUSTER_ID \
--region=REGION \
--project=PROJECT \
--direct-access-ports=80,8080
Solo puedes configurar el puerto 80 y los puertos en el rango de 1024 a 65535
como puertos de acceso directo. Tampoco puedes especificar más de ocho puertos de acceso directo
por clúster de estación de trabajo.
Restringe el acceso a los puertos de una estación de trabajo
Para restringir los puertos a los que se puede conectar en una estación de trabajo, establece
allowedPorts en la configuración de la estación de trabajo.
Para restringir un solo puerto, establece los campos first y last de PortRange en el mismo número de puerto.
De forma predeterminada, se permiten los puertos 22, 80 y del 1024 al 65535.
Para crear una configuración de estación de trabajo con acceso restringido a los puertos 80 y
8080 a 8100, ejecuta el siguiente comando de Google Cloud CLI:
gcloud workstations configs create CONFIG \
--cluster=CLUSTER_ID \
--region=REGION \
--project=PROJECT \
--allowed-ports=first=80,last=80 \
--allowed-ports=first=8080,last=8100
Solicitudes preliminares de CORS
De forma predeterminada, Cloud Workstations se asegura de que todas las solicitudes HTTP/HTTPS a la estación de trabajo se autentiquen con una cookie o un encabezado de autenticación.
Las solicitudes con verificación previa de uso compartido de recursos entre dominios (CORS) no incluyen cookies ni encabezados personalizados, por lo que Cloud Workstations las considera no autenticadas y las bloquea. De manera opcional, los administradores pueden permitir que las solicitudes de comprobación previa de CORS no autenticadas lleguen a la estación de trabajo, donde el servidor de destino de la estación de trabajo se encarga de validar la solicitud.
Para permitir solicitudes de CORS previas al vuelo no autenticadas, ejecuta el siguiente comando de Google Cloud CLI:
gcloud beta workstations configs update CONFIG \
--cluster=CLUSTER_ID \
--region=REGION \
--project=PROJECT \
--allow-unauthenticated-cors-preflight-requests
Inhabilitar el reemplazo de localhost en las respuestas HTTP
Para permitir que las apps en desarrollo se ejecuten de forma correcta en la estación de trabajo, Cloud Workstations reemplaza las referencias a localhost, 127.0.0.1 y 0.0.0.0 por el nombre de host de la estación de trabajo en las respuestas HTTP de la estación de trabajo.
Esto podría interferir con algunas aplicaciones. Para inhabilitar este comportamiento, ejecuta el siguiente comando de Google Cloud CLI:
gcloud beta workstations configs update CONFIG \
--cluster=CLUSTER_ID \
--region=REGION \
--project=PROJECT \
--disable-localhost-replacement