Risolvere i problemi di Cloud Workstations

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

Esegui il pull delle immagini di sistema sulle VM

Quando crei workstation utilizzando la configurazione della workstation, Cloud Workstations estrae le immagini di sistema nell'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).

Il mancato pull di queste immagini potrebbe impedirti di avviare le tue workstation. Ecco alcuni consigli:

Timeout durante il provisioning della VM

Quando crei workstation utilizzando la configurazione della workstation, Cloud Workstations crea un'istanza Compute Engine per supportare la 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 consigli:

Configura Cloud NAT o abilita l'accesso privato Google

Se hai disattivato 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 delle workstation.
  • Abilita l'accesso privato Google sulla tua 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 Artifact Registry e Container Registry, che corrispondono rispettivamente a *.pkg.dev e *.gcr.io.

Per saperne di più, consulta Configura l'accesso privato Google > Configurazione di rete avanzata.

Assicurati 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 da Virtual Private Cloud (VPC) all'interno del perimetro di servizio.

Aggiorna le regole firewall per consentire il traffico TCP in uscita

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

Esamina i log di avvio della VM di Compute Engine per individuare 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 attivato il logging della porta seriale nel progetto. Se hai specificato un account di servizio nella configurazione della workstation, assicurati che disponga dell'autorizzazione logging.logEntries.create sul progetto in modo che possa scrivere i log in Cloud Logging. Prova ad avviare nuovamente la workstation dopo aver attivato il logging della porta seriale e aver aggiunto le autorizzazioni necessarie per assicurarti che lo script di avvio della VM di Compute Engine venga eseguito di nuovo per generare i log.

Esamina i log dell'API Compute Engine per individuare 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 delle workstation.

Attiva gli attributi guest nel progetto

Per facilitare la procedura di risoluzione dei problemi, assicurati di non aver disattivato 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.

Errori intermittenti di forwarding del backend

Se visualizzi in modo intermittente gli errori "Impossibile inoltrare la richiesta a un backend" all'avvio di una workstation, è possibile che il server web della workstation non sia ancora completamente avviato.

Per risolvere il problema, aggiungi i controlli di idoneità alla configurazione della workstation. Un controllo di idoneità impedisce alla workstation di segnalare che è stata avviata finché il server sulla porta specificata non è pronto ad accettare richieste.

Esegui il debug delle workstation arrestate

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

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 appropriate per CMEK.

In particolare, verifica che l'agente di servizio Compute Engine (service-PROJECT_NUMBER@compute-system.) disponga del ruolo Cloud Key Management Service CryptoKey Encrypter/Decrypter (roles/cloudkms.cryptoKeyEncrypterDecrypter) sulla tua 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 Cripta le risorse delle workstation utilizzando CMEK.