Conectar-se a servidores HTTP em execução em uma estação de trabalho

Por padrão, é possível se conectar às portas HTTP 80 e 1024 a 65535 nas suas estações de trabalho pelo navegador. É possível restringir as portas que podem ser conectadas nas estações de trabalho definindo allowedPorts na configuração da estação de trabalho.

As estações de trabalho em execução têm uma propriedade host que pode ser usada para se conectar usando HTTP de um navegador remoto. Para encontrar a propriedade host, consulte os detalhes de uma estação de trabalho em execução usando a API, a Google Cloud CLI, o console do Google Cloud ou imprimindo a variável de ambiente $WEB_HOST, que é definida automaticamente na estação de trabalho. O URL se conecta à porta 80 por padrão.

Formato de URL padrão da estação de trabalho

O URL da propriedade host usa o seguinte formato por padrão:

https://PORT-WORKSTATION_NAME.CLUSTER_ID.cloudworkstations.dev

Os marcadores de posição representam o seguinte:

  • PORT: o número da porta, que é 80 por padrão.
  • WORKSTATION_NAME: o nome da estação de trabalho.
  • CLUSTER_ID: o identificador de cluster gerado aleatoriamente.
  • cloudworkstations.dev: o nome de domínio padrão de uma estação de trabalho.

    Os URLs de domínios personalizados usam um formato diferente. Para saber mais sobre como configurar domínios personalizados no Cloud Workstations, consulte Configurar domínios personalizados para o Cloud Workstations.

Conectar-se a uma porta diferente mudando o URL

Para se conectar em uma porta diferente, especifique um número de porta diferente como prefixo. Por exemplo, o URL a seguir se conecta à porta 9900:

https://9900-myworkstation.cluster-12345abcde.cloudworkstations.dev

Neste exemplo, observe o seguinte:

  • 9900: representa o número da porta.
  • myworkstation: representa o ID da estação de trabalho.
  • cluster-12345abcde: representa o identificador do cluster.
  • cloudworkstations.dev: representa o nome de domínio padrão de uma estação de trabalho.

Esses URLs exigem autenticação do usuário. Para abrir esses URLs, você precisa fazer login e ter o papel do IAM de usuário do Cloud Workstations, roles/workstations.user, ou a permissão workstations.workstations.use.

Se o cluster da estação de trabalho estiver configurado com portas de acesso direto, em vez de codificar a porta como um prefixo, será possível se conectar a uma porta configurada anexando :PORT ao nome do host da estação de trabalho. Por exemplo, depois de configurar a porta 9900 como uma porta de acesso direto, o URL a seguir também se conecta à porta 9900:

https://myworkstation.cluster-12345abcde.cloudworkstations.dev:9900

Conectar-se a um app HTTP pelo console do Google Cloud

É possível se conectar a um app HTTP em execução em uma estação de trabalho pelo console doGoogle Cloud .

Para qualquer estação de trabalho em execução que você tenha permissão para usar, um botão Iniciar será exibido. Por padrão, esse botão se conecta à porta 80. Clique na seta de expansão arrow_drop_down ao lado de Iniciar para ver outras opções de conexão. A opção Conectar ao app da Web na porta permite especificar uma porta diferente para conexão.

Conectar-se a um app HTTP pelo editor de base

Para se conectar a um app em execução na estação de trabalho usando o editor de base do Cloud Workstations, siga uma destas instruções:

  • Clique nos links do localhost no terminal. O editor de base redireciona automaticamente os links do localhost para os URLs certos.

    1. Para abrir uma janela do terminal, clique em menu Menu > Terminal > Novo terminal. Como alternativa, pressione Control+Shift+` (ou Command+Shift+` no macOS).

    2. No prompt de comando, execute o seguinte comando para exibir o link do localhost:

      echo http://localhost:PORT
      

      Substitua PORT por um número de porta, como 80 ou 8080.

    3. Mantenha pressionada a tecla Control (ou Command no macOS) e clique no link do localhost.
      Isso abre PORT-WORKSTATION_HOSTNAME no navegador.

  • Use a janela do navegador: acesse https://PORT-WORKSTATION_HOSTNAME, em que PORT é o número da porta e WORKSTATION_HOSTNAME é o nome do host da estação de trabalho.

Configurar portas de acesso direto

Por padrão, quando você se conecta a uma porta de estação de trabalho codificando a porta como um prefixo no URL, sua solicitação se conecta ao gateway do cluster pela porta HTTPS 443, e o gateway encaminha a solicitação para PORT na sua estação de trabalho.

Para se conectar diretamente a uma porta de estação de trabalho usando o formato de URL padrão https://WORKSTATION_NAME.CLUSTER_ID.cloudworkstations.dev:PORT, configure a porta como uma porta de acesso direto no cluster da estação de trabalho.

Para definir portas de acesso direto em um cluster de estações de trabalho, execute o seguinte comando da Google Cloud CLI:

    gcloud beta workstations clusters update CLUSTER_ID \
        --region=REGION \
        --project=PROJECT \
        --direct-access-ports=80,8080

Só é possível configurar a porta 80 e as portas no intervalo de 1024 a 65535 como portas de acesso direto. Também não é possível especificar mais de oito portas de acesso direto por cluster de estação de trabalho.

Restringir o acesso à porta de uma estação de trabalho

Para restringir as portas que podem ser conectadas em uma estação de trabalho, defina o allowedPorts nas configurações da estação de trabalho.

Para restringir uma única porta, defina os campos first e last de PortRange com o mesmo número de porta.

Por padrão, as portas 22, 80 e 1024 a 65535 são permitidas.

Para criar uma configuração de estação de trabalho com acesso restrito às portas 80 e 8080 para 8100, execute o seguinte comando da 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

Solicitações de simulação do CORS

Por padrão, o Cloud Workstations garante que todas as solicitações HTTP/HTTPS para a estação de trabalho sejam autenticadas usando um cookie ou cabeçalho de autenticação.

As solicitações de simulação de compartilhamento de recursos entre origens (CORS) não incluem cookies ou cabeçalhos personalizados e, portanto, são consideradas não autenticadas e bloqueadas pelo Cloud Workstations. Os administradores podem, se quiserem, permitir que solicitações de simulação do CORS não autenticadas sejam enviadas para a estação de trabalho, onde o servidor de destino na estação de trabalho será responsável por validar a solicitação.

Para permitir solicitações de simulação de CORS não autenticadas, execute o seguinte comando da Google Cloud CLI:

    gcloud beta workstations configs update CONFIG \
        --cluster=CLUSTER_ID \
        --region=REGION \
        --project=PROJECT \
        --allow-unauthenticated-cors-preflight-requests

Desativar a substituição de localhost em respostas HTTP

Para permitir que os apps em desenvolvimento sejam executados corretamente na estação de trabalho, o Cloud Workstations substitui as referências a localhost, 127.0.0.1 e 0.0.0.0 pelo nome do host da estação de trabalho nas respostas HTTP da estação de trabalho.

Isso pode interferir em alguns aplicativos. Para desativar esse comportamento, execute o seguinte comando da Google Cloud CLI:

    gcloud beta workstations configs update CONFIG \
        --cluster=CLUSTER_ID \
        --region=REGION \
        --project=PROJECT \
        --disable-localhost-replacement