Resolver problemas do Cloud Workstations

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

Extrair imagens do sistema para VMs

Quando você cria 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.

• Configure o Cloud NAT ou ative o Acesso privado do Google.
• Verifique se as APIs estão ativadas e acessíveis à VPC.
• Atualize as regras de firewall para permitir a saída de TCP.
• Examine os registros de inicialização da VM do Compute Engine para identificar possíveis erros.
• Ative os atributos de convidado no seu projeto.

Tempo limite para provisionar a VM

Quando você cria estações de trabalho usando a configuração delas, o Cloud Workstations cria um Compute Engine para fazer backup da estação. 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.

• Examine os registros de inicialização da VM do Compute Engine para identificar possíveis erros.
• Examine os registros da API Compute Engine para possíveis erros.
• Ative os atributos de convidado no seu projeto.

Configurar o Cloud NAT ou ativar o Acesso privado do Google

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

• Configure o Cloud NAT para permitir que o Cloud Workstations extraia imagens para as VMs de 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, é necessário 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 avançada de rede.

Verifique se as APIs estão ativadas e acessíveis pela 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 extraia 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"

Observação: os erros nos registros do script de inicialização não são necessariamente registrados na gravidade ERROR. Não adicione um filtro de gravidade ao procurar erros nos registros.

Se você não encontrar registros com esse filtro, verifique se ativou o registro da porta serial no 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 a 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 relata como mensagens de depuração específicas na configuração da estação de trabalho.

Depurar estações de trabalho interrompidas

Se as estações de trabalho pararem inesperadamente, verifique os registros da plataforma ou os registros de saída do contêiner para determinar a causa. Esses registros podem ajudar a identificar falhas de inicialização, desligamentos abruptos ou erros gerais da estação de trabalho.

Desligamentos simultâneos de estações de trabalho ao usar a CMEK

Se todas as estações de trabalho forem desligadas de uma vez e a configuração delas usar chaves de criptografia gerenciadas pelo cliente (CMEK), verifique se você configurou as permissões adequadas na CMEK.

Especificamente, verifique se o agente de serviço do Compute Engine ([e-mail]) tem o papel de criptografador/descriptografador de CryptoKey do Cloud Key Management Service (roles/cloudkms.cryptoKeyEncrypterDecrypter) na sua CMEK. Se o agente de serviço do Compute Engine não tiver as permissões necessárias para acessar as chaves, o Compute Engine vai encerrar automaticamente as VMs subjacentes. Para mais informações, consulte Criptografar recursos da estação de trabalho usando a CMEK.