Risolvere i problemi di Cloud Workstations

Questa pagina contiene informazioni per la risoluzione dei problemi che possono aiutarti a risolvere i problemi relativi a Cloud Workstations.

Eseguire il pull delle immagini di sistema sulle VM

Quando crei workstation utilizzando la configurazione della workstation, Cloud Workstations esegue il pull delle immagini di sistema sull'istanza della macchina virtuale (VM) da Artifact Registry (o Container Registry). Il messaggio di errore visualizzato è simile al seguente:

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 non riesci a eseguire il pull di queste immagini, potresti non essere in grado di avviare le workstation. Ecco alcuni suggerimenti:

Timeout durante il provisioning della VM

Quando crei workstation utilizzando la configurazione della workstation, Cloud Workstations crea un'istanza di Compute Engine per eseguire il backup della workstation. Se si verifica un errore durante il provisioning delle VM, il messaggio di errore visualizzato è simile al seguente:

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

Ecco alcuni suggerimenti:

Configurare Cloud NAT o abilitare l'accesso privato Google

Se hai disabilitato gli indirizzi IP pubblici nella configurazione, utilizza una delle seguenti opzioni:

  • Configura Cloud NAT per consentire a Cloud Workstations di eseguire il pull delle immagini sulle VM della workstation.

  • Abilita l'accesso privato Google sulla subnet. Se utilizzi i nomi di dominio private.googleapis.com o restricted.googleapis.com, crea record DNS per indirizzare il traffico agli indirizzi IP associati a questi domini. In particolare, devi assicurarti di abilitare l'accesso ai domini di Artifact Registry e Container Registry, che corrispondono rispettivamente a *.pkg.dev e *.gcr.io.

Per ulteriori informazioni, consulta Configurare l'accesso privato Google > Configurazione di rete avanzata.

Assicurarsi che le API siano abilitate e accessibili tramite VPC

Se il tuo progetto si trova all'interno di un perimetro dei Controlli di servizio VPC, assicurati che l'API Cloud Storage, l'API Container Registry e l'API Artifact Registry siano accessibili tramite Virtual Private Cloud (VPC) all'interno del perimetro di servizio.

Aggiornare le regole firewall per consentire il traffico in uscita TCP

Assicurati di consentire il traffico in uscita TCP nella rete sulle porte 80 e 443 per consentire a Cloud Workstations di eseguire il pull delle immagini sulla workstation.

Esaminare i log di avvio delle VM di Compute Engine per verificare la presenza di possibili errori

Le VM create da Cloud Workstations generano log di debug nella console seriale all'avvio. Questi log possono essere utili quando il servizio va in timeout durante la creazione di una VM. I nomi delle VM create per le workstation iniziano con workstations- seguito da un identificatore univoco. Utilizza il seguente filtro per filtrare i log in Esplora log:

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

Se non vedi log con questo filtro, assicurati di aver abilitato il logging delle porte seriali nel tuo progetto. Se hai specificato un account di servizio nella configurazione della workstation, assicurati che l'account di servizio disponga dell'autorizzazione logging.logEntries.create per il progetto in modo che possa scrivere i log in Cloud Logging. Prova ad avviare di nuovo la workstation dopo aver abilitato il logging delle porte seriali e aggiunto le autorizzazioni necessarie per assicurarti che lo script di avvio della VM di Compute Engine venga eseguito di nuovo per generare i log.

Esaminare i log dell'API Compute Engine per verificare la presenza di possibili errori

Utilizza il seguente filtro per i log di Stackdriver:

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

Gli errori dell'API Compute Engine potrebbero bloccare la creazione delle VM della workstation.

Abilitare gli attributi guest nel progetto

Per facilitare la procedura di risoluzione dei problemi, assicurati di non aver disabilitato gli attributi guest per il tuo progetto. Cloud Workstations utilizza questi attributi per rilevare determinati problemi all'avvio di una workstation e li segnala come messaggi di debug specifici nella configurazione della workstation.

Eseguire il debug delle workstation arrestate

Se le workstation si arrestano in modo imprevisto, controlla i log della piattaforma o i log di output dei container per determinare la causa. Questi log possono aiutarti a identificare gli errori di avvio della workstation, gli arresti anomali o gli errori generali.

Arresti simultanei delle workstation quando si utilizza CMEK

Se tutte le workstation si arrestano contemporaneamente e la configurazione della workstation utilizza chiavi di crittografia gestite dal cliente (CMEK), verifica di aver configurato le autorizzazioni corrette per CMEK.

In particolare, verifica che l'agente di servizio Compute Engine (service-PROJECT_NUMBER@compute-system.iam.gserviceaccount.com) abbia il ruolo Cloud Key Management Service CryptoKey Encrypter/Decrypter (roles/cloudkms.cryptoKeyEncrypterDecrypter) su CMEK. Se l'agente di servizio Compute Engine non dispone delle autorizzazioni necessarie per accedere alle chiavi, Compute Engine arresta automaticamente le VM sottostanti. Per ulteriori informazioni, consulta Criptare le risorse della workstation utilizzando CMEK.