Configurar domínios personalizados para o Cloud Workstations

Para acessar as estações de trabalho, especifique um domínio personalizado confiável em vez de usar o domínio cloudworkstations.dev.

Arquitetura

Para usar o Cloud Workstations com um nome de host personalizado, configure um cluster particular e configure o endpoint do Private Service Connect (PSC) para entrada HTTP do cluster. Também é necessário criar um balanceador de carga de aplicativo com back-end do PSC que tenha como destino o endpoint do PSC criado para o cluster particular. Esse balanceador de carga de aplicativo pode ser externo ou interno e gerencia o certificado SSL do seu domínio personalizado.

O diagrama a seguir ilustra um cluster com um domínio personalizado:

Figura 1. Cluster com domínio personalizado

Antes de começar

Para configurar um domínio personalizado do Cloud Workstations, siga estas etapas:

  1. Crie um cluster particular e especifique um domínio personalizado confiável usando os comandos da CLI gcloud ou da API REST.

  2. Crie um balanceador de carga de aplicativo externo global com um back-end do Private Service Connect (PSC) no mesmo projeto usado para o cluster da estação de trabalho. Observe o seguinte:

    1. Se você quiser que as estações de trabalho sejam particulares (inacessíveis pela Internet pública), crie um balanceador de carga interno. Para fazer isso, crie uma zona de DNS particular e adicione um registro que mapeie o domínio para o endereço IP interno usado pelo balanceador de carga. Para mais informações sobre como criar um balanceador de carga interno, consulte a nuvem privada virtual (VPC).

    2. O anexo de serviço que você precisa referenciar no balanceador de carga pode ser acessado no recurso do cluster da estação de trabalho depois de criar o cluster.

    3. Adquira um certificado e especifique-o no balanceador de carga como um certificado curinga para seu domínio, por exemplo, *.us-west1-cluster1.example.com. Consulte Certificados e Google Cloud balanceadores de carga para saber os tipos de certificados compatíveis com o balanceador de carga selecionado.

    4. Também é possível criar o balanceador de carga em um projeto diferente, desde que você o adicione à lista PrivateClusterConfig.allowedProjects.

    5. Se você tiver vários clusters de estação de trabalho na sua organização, poderá usar um único balanceador de carga com serviços de back-end, certificados e regras de roteamento separados.

  3. Configure um sistema de nomes de domínio (DNS). Como esse é um domínio gerenciado por você, configure um DNS para ele mapeando todos os subdomínios do domínio fornecido para o balanceador de carga. Por exemplo, crie uma zona de DNS para us-west1-cluster1.example.com e adicione uma entrada que mapeie *.us-west1-cluster1.example.com para o endereço IP externo usado pelo balanceador de carga.

  4. Para acessar as estações de trabalho usando o domínio personalizado, use o cluster criado para criar uma configuração de estação de trabalho, e, em seguida, crie uma estação de trabalho usando essa configuração.

  5. Inicie a estação de trabalho e verifique o URL. Ao especificar um domínio personalizado, o URL da estação de trabalho usa o seguinte formato:

    https://PORT-WORKSTATION_NAME.DOMAIN

    As partes a seguir do URL dependem da sua configuração:

    • PORT: o número da porta, que é 80 por padrão.
    • WORKSTATION_NAME: o nome da estação de trabalho.
    • DOMAIN: o nome de domínio específico do cluster.

Criar um cluster particular

Crie um cluster de estação de trabalho particular com um endpoint particular:

gcloud

  1. Antes de começar, certifique-se de que você inicializou a CLI gcloud executando gcloud init e que você especificou um projeto padrão. Os exemplos a seguir pressupõem que você definiu o projeto padrão.

  2. Para criar um cluster de estação de trabalho particular, execute o seguinte comando:

    gcloud workstations clusters create WORKSTATION_CLUSTER \
  --region=REGION \
  --domain=DOMAIN \
  --network=NETWORK \
  --subnetwork=SUBNETWORK \
  --enable-private-endpoint

    Substitua:

    • WORKSTATION_CLUSTER: o nome do cluster de estação de trabalho a ser criado.
    • REGION: o nome da região do cluster.
    • DOMAIN: o nome de domínio usado pelo Cloud Workstations para entrada HTTP. Use um subdomínio exclusivo para esse cluster, por exemplo, us-west1-cluster1.example.com.
    • NETWORK: o nome da rede VPC. Se omitida, a VPC padrão será usada.
    • SUBNETOWRK: o nome da sub-rede na rede VPC. Se a rede e a sub-rede forem omitidas, a VPC padrão e a sub-rede padrão na REGION especificada serão usadas.

Para mais informações sobre esse gcloud comando da CLI, consulte a gcloud workstations clusters create documentação de referência.

curl

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  -d '{"domain_config": {"domain": "DOMAIN"}, "private_cluster_config": {"enable_private_endpoint":true}, "network": "NETWORK", "subnetwork": "SUBNETWORK"}'  https://workstations.googleapis.com/v1/projects/PROJECT_NAME/locations/REGION/workstationClusters?workstation_cluster_id=WORKSTATION_CLUSTER

Substitua:

  • DOMAIN: o nome de domínio usado pelo Cloud Workstations para entrada HTTP. Esse precisa ser um subdomínio exclusivo para esse cluster, por exemplo, us-west1-cluster1.example.com.
  • NETWORK: o nome da rede VPC. Se omitida, a VPC padrão será usada.
  • SUBNETOWRK: o nome da sub-rede na rede VPC. Se a rede e a sub-rede forem omitidas, a VPC padrão e a sub-rede padrão na REGION especificada serão usadas.
  • PROJECT_NAME: o nome do projeto.
  • REGION: o nome da região do cluster.
  • WORKSTATION_CLUSTER: o nome do cluster de estação de trabalho a ser criado.

Para mais informações sobre esse método de API, consulte a workstationClusters.create documentação de referência.

REST

POST https://workstations.googleapis.com/v1/projects/PROJECT_NAME/locations/REGION/workstationClusters?workstationClusterId=WORKSTATION_CLUSTER
{
  "domainConfig": {
    "domain": "DOMAIN"
  },
  "privateClusterConfig": {
    "enablePrivateEndpoint": true
  }
  "network": "NETWORK"
  "subnetwork": "SUBNETWORK"
}

Substitua:

  • PROJECT_NAME: o nome do projeto.
  • REGION: o nome da região do cluster.
  • WORKSTATION_CLUSTER: o nome do cluster de estação de trabalho a ser criado.
  • DOMAIN: o nome de domínio usado pelo Cloud Workstations para entrada HTTP. Esse precisa ser um subdomínio exclusivo para esse cluster, por exemplo, us-west1-cluster1.example.com.
  • NETWORK: o nome da rede VPC. Se omitida, a VPC padrão será usada.
  • SUBNETOWRK: o nome da sub-rede na rede VPC. Se a rede e a sub-rede forem omitidas, a VPC padrão e a sub-rede padrão na REGION especificada serão usadas.

Para mais informações sobre esse método de API, consulte a workstationClusters.create documentação de referência.

Criar um balanceador de carga de aplicativo externo global com back-end do PSC

Siga estas etapas da CLI gcloud e da API REST para criar um balanceador de carga de aplicativo externo global com um back-end do PSC:

  1. Criar um NEG para se conectar a um serviço publicado
  2. Adicionar um back-end a um balanceador de carga de aplicativo externo global
  3. Criar um mapa de URL para rotear solicitações recebidas para o serviço de back-end
  4. Criar um proxy HTTPS de destino
  5. Criar um endereço global
  6. Criar uma regra de encaminhamento

Criar um NEG para se conectar a um serviço publicado

Ao criar um NEG que aponta para um serviço publicado, você precisa do URI de anexo do serviço para o serviço. O anexo de serviço tem este formato: projects/SERVICE_PROJECT/regions/REGION/serviceAttachments/SERVICE_NAME. É possível encontrar o URI no recurso do cluster da estação de trabalho.

gcloud

gcloud compute network-endpoint-groups create NEG_NAME \
  --network-endpoint-type=private-service-connect \
  --psc-target-service=TARGET_SERVICE \
  --region=REGION \
  --subnet=SUBNET

Substitua:

  • NEG_NAME: um nome para o grupo de endpoints da rede.
  • TARGET_SERVICE: o URI do anexo de serviço.
  • REGION: a região em que o grupo de endpoints da rede será criado. A região precisa ser igual à do serviço de destino.
  • SUBNET: a sub-rede em que o grupo de endpoints da rede será criado. A sub-rede precisa estar na mesma região do serviço de destino. Uma sub-rede precisa ser informada se você fornecer a rede. Se a rede e a sub-rede forem omitidas, a rede padrão e a sub-rede padrão na REGION especificada serão usadas.

Para mais informações sobre esse gcloud comando da CLI, consulte a gcloud compute network-endpoint-groups create documentação de referência.

REST

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/regions/REGION/networkEndpointGroups
{
  "pscTargetService": "TARGET_SERVICE",
  "networkEndpointType": "PRIVATE_SERVICE_CONNECT",
  "name": "NEG_NAME"
}

Substitua:

  • PROJECT_NAME: o nome do projeto.
  • REGION: a região em que o grupo de endpoints da rede será criado. A região precisa ser igual à do serviço de destino.
  • NEG_NAME: um nome para o grupo de endpoints da rede.
  • TARGET_SERVICE: o URI do anexo de serviço.

Adicionar um back-end a um balanceador de carga de aplicativo externo global

gcloud

  1. Crie um serviço de back-end para o serviço de destino:

    gcloud compute backend-services create BACKEND_SERVICE_NAME \
--load-balancing-scheme=EXTERNAL_MANAGED \
--protocol=HTTPS \
--global

    Substitua BACKEND_SERVICE_NAME pelo nome do serviço de back-end.

  2. Adicione o NEG do Private Service Connect que aponta para o serviço de destino.

    gcloud compute backend-services add-backend BACKEND_SERVICE_NAME \
--network-endpoint-group=NEG_NAME \
--network-endpoint-group-region=NEG_REGION \
--global

    Substitua:

    • BACKEND_SERVICE_NAME: o nome do serviço de back-end.
    • NEG_NAME: o nome do grupo de endpoints da rede.
    • NEG_REGION: a região do grupo de endpoints da rede.

Para mais informações sobre esse gcloud comando da CLI, consulte a gcloud compute backend-services create e gcloud compute backend-services add-backend documentação de referência.

REST

  1. Crie um serviço de back-end para o serviço de destino:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/global/backendServices
{
  "protocol": "HTTPS",
  "loadBalancingScheme": "EXTERNAL_MANAGED",
  "name": "BACKEND_SERVICE_NAME"
}

    Substitua BACKEND_SERVICE_NAME pelo nome do serviço de back-end.

  2. Adicione o NEG do Private Service Connect que aponta para o serviço de destino.

    PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/global/backendServices/BACKEND_SERVICE_NAME
{
  "backends": [
    {
      "group": "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/regions/NEG_REGION/networkEndpointGroups/NEG_NAME "
    }
  ]
}

    Substitua:

    • PROJECT_NAME: o nome do projeto.
    • BACKEND_SERVICE_NAME: o nome do serviço de back-end.
    • NEG_REGION: a região do grupo de endpoints da rede.
    • NEG_NAME: o nome do grupo de endpoints da rede.

Criar um mapa de URL para rotear solicitações recebidas para o serviço de back-end

gcloud

gcloud compute url-maps create URL_MAP_NAME \
  --default-service=BACKEND_SERVICE_NAME \
  --global

Substitua:

  • URL_MAP_NAME: o nome do mapa de URL a ser criado.
  • BACKEND_SERVICE_NAME: o nome do serviço de back-end a ser usado para solicitações quando esse mapa de URL não tiver mapeamentos.

Para mais informações sobre esse gcloud comando da CLI, consulte a gcloud compute url-maps create documentação de referência.

REST

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/global/urlMaps
{
  "name": "URL_MAP_NAME",
  "defaultService": "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/global/backendServices/BACKEND_SERVICE_NAME "
}

Substitua:

  • PROJECT_NAME: o nome do projeto.
  • URL_MAP_NAME: o nome do mapa de URL a ser criado.
  • BACKEND_SERVICE_NAME: o nome do serviço de back-end a ser usado para solicitações quando esse mapa de URL não tiver mapeamentos.

Criar um proxy HTTPS de destino

Crie um proxy de destino HTTPS para encaminhar solicitações ao mapa de URL. O proxy é a parte do balanceador de carga que contém o certificado SSL para balanceamento de carga HTTPS. Portanto, nesta etapa também é possível carregar o certificado:

gcloud

gcloud compute target-https-proxies create TARGET_HTTPS_PROXY_NAME \
  --ssl-certificates=SSL_CERTIFICATE_NAME \
  --url-map=URL_MAP_NAME \
  --global

Substitua:

  • TARGET_HTTPS_PROXY_NAME: o nome do proxy HTTPS de destino a ser criado.
  • SSL_CERTIFICATE_NAME: o certificado SSL associado ao balanceador de carga.
  • URL_MAP_NAME: o recurso do mapa de URL.

Para mais informações sobre esse gcloud comando da CLI, consulte a gcloud compute target-https-proxies create documentação de referência.

REST

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/global/targetHttpsProxies
{
  "sslCertificates": [
    "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/global/sslCertificates/SSL_CERTIFICATE_NAME"
  ],
  "urlMap": "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/global/urlMaps/URL_MAP_NAME",
  "name": "TARGET_HTTPS_PROXY_NAME"
}

Substitua:

  • PROJECT_NAME: o nome do projeto.
  • SSL_CERTIFICATE_NAME: o certificado SSL associado ao balanceador de carga.
  • URL_MAP_NAME: o recurso do mapa de URL.
  • TARGET_HTTPS_PROXY_NAME: o nome do proxy HTTPS de destino a ser criado.

Criar um endereço global

Reserve um endereço IP estático para ser usado pelo balanceador de carga:

gcloud

gcloud compute addresses create LB_IP_ADDRESS_NAME \
  --global

Substitua:

  • LB_IP_ADDRESS_NAME: o nome do endereço IP estático externo ou interno reservado do balanceador de carga.

Para mais informações sobre esse gcloud comando da CLI, consulte a gcloud compute addresses create documentação de referência.

REST

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/global/addresses
{
  "name": "LB_IP_ADDRESS_NAME"
}

Substitua:

  • PROJECT_NAME: o nome do projeto.
  • LB_IP_ADDRESS_NAME: o nome do endereço IP estático externo ou interno reservado do balanceador de carga.

Criar uma regra de encaminhamento

Crie uma regra de encaminhamento para encaminhar as solicitações recebidas para o proxy:

gcloud

gcloud compute forwarding-rules create HTTPS_FORWARDING_RULE_NAME \
  --load-balancing-scheme=EXTERNAL_MANAGED \
  --network-tier=PREMIUM \
  --address=LB_IP_ADDRESS_NAME  \
  --target-https-proxy=TARGET_HTTPS_PROXY_NAME  \
  --global \
  --ports=443

Substitua:

  • HTTPS_FORWARDING_RULE_NAME: o nome da regra de encaminhamento a ser criada.
  • LB_IP_ADDRESS_NAME: o nome do endereço IP estático externo ou interno reservado do balanceador de carga.
  • TARGET_HTTPS_PROXY_NAME: o proxy HTTPS de destino que recebe o tráfego.

Para mais informações sobre esse gcloud comando da CLI, consulte a gcloud compute forwarding-rules create documentação de referência.

REST

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/global/forwardingRules
{
  "loadBalancingScheme": "EXTERNAL_MANAGED",
  "networkTier": "PREMIUM",
  "IPAddress": "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/global/addresses/LB_IP_ADDRESS_NAME",
  "target": "https://www.googleapis.com/compute/v1/projects/PROJECT_NAME/global/targetHttpsProxies/TARGET_HTTPS_PROXY_NAME",
  "name": "HTTPS_FORWARDING_RULE_NAME",
  "portRange": "443-443"
}

Substitua:

  • PROJECT_NAME: o nome do projeto.
  • LB_IP_ADDRESS_NAME: o nome do endereço IP estático externo ou interno reservado do balanceador de carga.
  • TARGET_HTTPS_PROXY_NAME: o proxy HTTPS de destino que recebe o tráfego.
  • HTTPS_FORWARDING_RULE_NAME: o nome da regra de encaminhamento a ser criada.

Configurar um DNS

Configure um DNS e adicione um registro que mapeie *.DOMAIN, por exemplo, *.example.com, para o endereço IP reservado na etapa anterior. Se você estiver usando o Cloud DNS para gerenciar o DNS do seu domínio, consulte Adicionar um registro DNS.

Criar a configuração e a estação de trabalho

Para acessar as estações de trabalho usando o domínio personalizado, faça o seguinte:

  1. Use o cluster com o domínio personalizado para criar uma configuração de estação de trabalho.

  2. Crie uma estação de trabalho usando a configuração da estação de trabalho com o domínio personalizado.

A seguir

Para mais informações sobre como configurar domínios personalizados e clusters particulares, consulte o seguinte: