Questa pagina contiene informazioni sulla risoluzione dei problemi relativi a Cloud Workstations.
Estrai le immagini di sistema nelle VM
Quando crei le workstation utilizzando la configurazione della workstation, Cloud Workstations estrae le immagini di sistema nella tua 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 riuscire ad avviare le tue stazioni di lavoro. Ecco alcuni consigli:
- Configura Cloud NAT o abilita l'accesso privato Google.
- Assicurati che le API siano abilitate e accessibili alla VPC.
- Aggiorna le regole del firewall per consentire l'uscita TCP.
- Esamina i log di avvio della VM Compute Engine per rilevare eventuali errori.
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 estrarre le immagini nelle VM della workstation.
Abilita l'accesso privato Google nella tua subnet. Se utilizzi i nomi di dominio
private.googleapis.comorestricted.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.deve*.gcr.io.
Per ulteriori informazioni, consulta Configurare l'accesso privato Google > Configurazione di rete avanzata.
Assicurati che le API siano abilitate e accessibili alla VPC
Se il tuo progetto si trova all'interno di un perimetro di 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 del 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 estrarre le immagini sulla tua workstation.
Esamina i log di avvio della VM Compute Engine per individuare eventuali errori
Se nessuno dei passaggi precedenti risolve il problema, potresti riuscire a trovare il motivo dell'errore nei log dello script di avvio della VM Compute Engine. I nomi delle VM create per la configurazione iniziano conCONFIG_NAME- seguito da un identificatore univoco.
Utilizza il seguente filtro per filtrare i log di Stackdriver:
SEARCH("CONFIG_NAME")
sourceLocation.function="main.setupAndRunScript"
Sostituisci quanto segue:
CONFIG_NAME: il nome della configurazione della workstation.
Se non visualizzi alcun log con questo filtro, assicurati di aver abilitato il logging della porta seriale nel tuo progetto. Se hai specificato un account di servizio nella configurazione della workstation, assicurati che disponga dell'autorizzazione logginglogEntries.create per il progetto in modo da poter scrivere i log in Cloud Logging. Prova a riavviare la workstation dopo aver attivato la registrazione della porta seriale e aver aggiunto le autorizzazioni necessarie per assicurarti che lo script di avvio della VM Compute Engine venga eseguito di nuovo per generare i log.