Resolva problemas das Cloud Workstations

Esta página contém informações de resolução de problemas para ajudar a resolver problemas com as estações de trabalho na nuvem.

Transfira imagens do sistema para VMs

Quando cria estações de trabalho com a configuração da estação de trabalho, o Cloud Workstations extrai imagens do sistema para a instância da máquina virtual (VM) a partir do Artifact Registry (ou do Container Registry). A mensagem de erro apresentada é semelhante à seguinte:

System images cannot be pulled onto workstation VMs using this configuration.
Ensure that you have set up Cloud NAT or enabled Private Google Access for
Artifact Registry (and Container Registry).

Se não conseguir obter estas imagens, pode não conseguir iniciar as suas estações de trabalho. Seguem-se algumas recomendações:

O aprovisionamento da VM excede o tempo limite

Quando cria estações de trabalho com a configuração de estações de trabalho, o Cloud Workstations cria uma instância do Compute Engine para suportar a estação de trabalho. Se ocorrer um erro no aprovisionamento das VMs, a mensagem de erro apresentada é semelhante à seguinte:

Workstations using this configuration cannot be provisioned due to an unknown error.

Seguem-se algumas recomendações:

Configure a NAT na nuvem ou ative o Acesso privado do Google

Se desativou os endereços IP públicos na sua configuração, use uma das seguintes opções:

  • Configure o Cloud NAT para permitir que as estações de trabalho na nuvem extraiam imagens para as VMs da estação de trabalho.

  • Ative o acesso privado à Google na sua sub-rede. Se usar os nomes de domínio private.googleapis.com ou restricted.googleapis.com, crie registos DNS para direcionar o tráfego para os endereços IP associados a esses domínios. Especificamente, tem de garantir que ativa o acesso aos domínios do Artifact Registry e do Container Registry, que correspondem, respetivamente, a *.pkg.dev e *.gcr.io.

Para mais informações, consulte o artigo Configure o acesso privado à Google > Configuração de rede avançada.

Certifique-se de que as APIs estão ativadas e são acessíveis através da VPC

Se o seu projeto estiver dentro de um perímetro do VPC Service Controls, certifique-se de que a API Cloud Storage, a API Container Registry e a API Artifact Registry são acessíveis através da nuvem virtual privada (VPC) no seu perímetro de serviço.

Atualize as regras de firewall para permitir a saída TCP

Certifique-se de que permite a saída TCP na sua rede nas portas 80 e 443 para permitir que as estações de trabalho do Google Cloud extraiam imagens para a sua estação de trabalho.

Examine os registos de arranque da VM do Compute Engine para verificar se existem possíveis erros

As VMs criadas pelas estações de trabalho na nuvem enviam registos de depuração para a consola de série no arranque. Estes registos podem ser úteis quando o serviço excede o limite de tempo ao criar uma VM. Os nomes das VMs criados para estações de trabalho começam com workstations-, seguido de um identificador exclusivo. Use o seguinte filtro para filtrar os registos no Explorador de registos:

SEARCH("workstations-")
sourceLocation.function="main.setupAndRunScript"

Se não vir registos com este filtro, certifique-se de que ativou o registo de portas de série no seu projeto. Se especificou uma conta de serviço na configuração da estação de trabalho, certifique-se de que a conta de serviço tem autorização logging.logEntries.create no projeto para poder escrever registos no Cloud Logging. Tente iniciar novamente a estação de trabalho depois de ativar o registo da porta série e adicionar as autorizações necessárias para garantir que o script de arranque da VM do Compute Engine é executado novamente para gerar os registos.

Examine os registos da API Compute Engine para verificar se existem possíveis erros

Use o seguinte filtro nos registos do Stackdriver:

protoPayload.serviceName="compute.googleapis.com"
severity>=ERROR

Os erros da API Compute Engine podem estar a bloquear a criação das VMs da estação de trabalho.

Ative os atributos de hóspedes no seu projeto

Para ajudar no processo de resolução de problemas, certifique-se de que não desativou os atributos de hóspedes para o seu projeto. As estações de trabalho na nuvem usam estes atributos para detetar determinados problemas quando inicia uma estação de trabalho e comunicam esses problemas como mensagens de depuração específicas na configuração da estação de trabalho.