Risolvere i problemi di Cloud Workstations

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

Estrai le immagini di sistema sulle VM

Quando crei workstation utilizzando la configurazione della workstation, Cloud Workstations recupera le immagini di sistema nell'istanza di 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 esegui il pull di queste immagini, potresti non essere in grado 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 nelle VM 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 ulteriori informazioni, vedi Configurare l'accesso privato Google > Configurazione avanzata della rete.

Assicurati che le API siano abilitate e accessibili al 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 a Virtual Private Cloud (VPC) all'interno del perimetro di servizio.

Aggiorna le regole firewall per consentire l'uscita TCP

Assicurati di consentire l'uscita TCP 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 alcun log con questo filtro, assicurati di aver attivato il logging delle porte seriali nel tuo progetto. Se hai specificato un account di servizio nella configurazione della workstation, assicurati che disponga dellaccount di servizio#39;autorizzazione logging.logEntries.create per il progetto in modo che possa scrivere i log in Cloud Logging. Prova a riavviare la workstation dopo aver attivato la registrazione della porta seriale e aggiunto le autorizzazioni necessarie per assicurarti che lo script di avvio della VM 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 Stackdriver:

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

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

Abilitare gli attributi guest nel progetto

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