Questa pagina contiene informazioni sulla risoluzione dei problemi relativi a Cloud Workstations.
Estrai le immagini di sistema nelle VM
Quando crei workstation utilizzando la configurazione delle workstation, Cloud Workstations esegue il pull delle immagini di sistema sulla VM da Artifact Registry (o Container Registry). Il messaggio di errore visualizzato è simile seguenti:
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 recupero di queste immagini potrebbe impedirti di avviare il tuo di lavoro. Ecco alcuni consigli:
- Configura Cloud NAT o abilita l'accesso privato Google.
- Assicurati che le API siano abilitate e accessibili al 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 disabilitato gli indirizzi IP pubblici nella tua configurazione, utilizza uno dei seguenti le seguenti opzioni:
Configura Cloud NAT per consentire a Cloud Workstations di eseguire il pull delle immagini sulle VM delle workstation.
Abilitare l'accesso privato Google della 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, vedi Configurare l'accesso privato Google > Avanzata configurazione di rete.
Assicurati che le API siano abilitate e accessibili al 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 Virtual Private Cloud (VPC) accessibili all'interno del perimetro di servizio.
Aggiorna le regole del firewall per consentire il traffico TCP in uscita
Assicurati di consentire l'uscita TCP nella tua rete sulle porte 80 e 443 per consentire alle stazioni di lavoro Cloud di estrarre le immagini sulla tua workstation.
Esamina i log di avvio delle VM di Compute Engine per individuare eventuali errori
Se nessuno dei passaggi precedenti risolve il problema, potresti trovare il motivo dell'errore in
i log degli script di avvio
delle VM di Compute Engine. I nomi delle VM creati per la configurazione iniziano con
CONFIG_NAME- seguito da un identificatore univoco.
Usa il filtro seguente 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 vedi alcun log con questo filtro, assicurati di aver abilitato il logging delle porte seriali sul tuo progetto. Se hai specificato un account di servizio nella configurazione della workstation, assicurati che l'account di servizio abbia l'autorizzazione logginglogEntries.create per il progetto in modo che possa scrivere log in Cloud Logging. Prova ad avviare di nuovo la workstation dopo aver abilitato il logging delle porte seriali e aggiungendo le autorizzazioni necessarie per garantire che lo script di avvio della VM Compute Engine venga eseguito di nuovo per generare i log.