Conéctate a servidores HTTP que se ejecutan en una estación de trabajo

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 puerto 80 de 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.

    1. 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).

    2. En el símbolo del sistema, ejecuta el siguiente comando para mostrar el vínculo de localhost:

      echo http://localhost:PORT
      

      Reemplaza PORT por un número de puerto, como 80 o 8080.

    3. Mantén presionada la tecla Control (o Comando en macOS) y, luego, haz clic en el vínculo de localhost.
      Se abrirá PORT-WORKSTATION_HOSTNAME en tu navegador.

  • Usa la ventana del navegador: navega a https://PORT-WORKSTATION_HOSTNAME, en el que PORT es el número de puerto y WORKSTATION_HOSTNAME es 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