Resolver problemas do Cloud Workstations

Esta página contém informações de solução de problemas para ajudar você a resolver problemas com as Cloud Workstations.

Extrair imagens do sistema para VMs

Ao criar estações de trabalho usando a configuração delas, o Cloud Workstations extrai imagens do sistema para a instância de máquina virtual (VM) do Artifact Registry (ou Container Registry). A mensagem de erro que aparece é semelhante a esta:

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 você não extrair essas imagens, talvez não consiga iniciar as estações de trabalho. Veja algumas recomendações.

Tempo limite para provisionar sua VM

Quando você cria estações de trabalho usando a configuração delas, o Cloud Workstations cria um Compute Engine para dar suporte a elas. Se houver um erro ao provisionar as VMs, a mensagem de erro exibida será semelhante a esta:

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

Veja algumas recomendações.

Configurar o Cloud NAT ou ativar o Acesso privado do Google

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

  • Configure o Cloud NAT para permitir que Cloud Workstations extraiam imagens para as VMs da estação de trabalho.

  • Ative o Acesso privado do Google na sua sub-rede. Se você usa os nomes de domínio private.googleapis.com ou restricted.googleapis.com, crie registros DNS para direcionar o tráfego aos endereços IP associados a esses domínios. Especificamente, você precisa ativar o acesso aos domínios do Artifact Registry e do Container Registry, que correspondem, respectivamente, a *.pkg.dev e *.gcr.io.

Para mais informações, consulte "Configurar o Acesso privado do Google" > Configuração de rede avançada.

Verifique se as APIs estão ativadas e acessíveis à VPC

Se o projeto estiver dentro de um perímetro do VPC Service Controls, verifique se as APIs Cloud Storage, Container Registry e API Artifact Registry são acessíveis pela nuvem privada virtual (VPC) no perímetro de serviço.

Atualizar regras de firewall para permitir a saída TCP

Permita a saída de TCP na sua rede nas portas 80 e 443 para que o Cloud Workstations possa extrair imagens para sua estação de trabalho.

Analise os registros de inicialização da VM do Compute Engine para identificar possíveis erros.

As VMs criadas pelo Cloud Workstations geram registros de depuração no console serial na inicialização. Esses registros podem ser úteis quando o serviço expira ao criar uma VM. Os nomes de VM criados para estações de trabalho começam com workstations- seguido de um identificador exclusivo. Use o filtro a seguir para filtrar seus registros no Explorador de registros:

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

Se você não encontrar registros com esse filtro, verifique se ativou a geração de registros da porta serial no seu projeto. Se você especificou uma conta de serviço na configuração da estação de trabalho, verifique se ela tem permissão logging.logEntries.create no projeto para gravar registros no Cloud Logging. Tente iniciar sua estação de trabalho novamente depois de ativar o registro da porta serial e adicionar as permissões necessárias para garantir que o script de inicialização da VM do Compute Engine seja executado novamente para gerar os registros.

Examine os registros da API Compute Engine em busca de possíveis erros

Use o seguinte filtro nos registros do Stackdriver:

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

Erros da API Compute Engine podem estar bloqueando a criação das VMs da estação de trabalho.

Ativar atributos de convidado no projeto

Para ajudar no processo de solução de problemas, verifique se você não desativou os atributos de convidado do seu projeto. O Cloud Workstations usa esses atributos para detectar determinados problemas ao iniciar uma estação de trabalho e os informa como mensagens de depuração específicas na configuração da estação de trabalho.