Fehlerbehebung bei Cloud Workstations

Auf dieser Seite finden Sie Informationen zur Fehlerbehebung bei Problemen mit Cloud Workstations.

System-Images auf VMs übertragen

Wenn Sie Workstations mit Ihrer Workstation-Konfiguration erstellen, ruft Cloud Workstations System-Images aus Artifact Registry (oder Container Registry) auf Ihre virtuelle Maschine (VM)-Instanz ab. Die angezeigte Fehlermeldung sieht in etwa so aus:

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).

Wenn diese Images nicht abgerufen werden können, können Sie Ihre Workstations möglicherweise nicht starten. Hier einige Empfehlungen:

Zeitüberschreitung beim Bereitstellen der VM

Wenn Sie Workstations mit Ihrer Workstation-Konfiguration erstellen, erstellt Cloud Workstations eine Compute Engine-VM zur Unterstützung Ihrer Workstation. Wenn beim Bereitstellen Ihrer VMs ein Fehler auftritt, sieht die angezeigte Fehlermeldung in etwa so aus:

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

Hier einige Empfehlungen:

Cloud NAT einrichten oder privater Google-Zugriff aktivieren

Wenn Sie öffentliche IP-Adressen in Ihrer Konfiguration deaktiviert haben, haben Sie folgende Möglichkeiten:

  • Richten Sie Cloud NAT ein, damit Cloud Workstations Images auf Ihre Workstation-VMs übertragen kann.

  • Aktivieren Sie den privaten Google-Zugriff in Ihrem Subnetz. Wenn Sie die Domainnamen private.googleapis.com oder restricted.googleapis.com verwenden, erstellen Sie DNS-Einträge, um den Traffic an die diesen Domains zugewiesenen IP-Adressen weiterzuleiten. Achten Sie darauf, dass Sie den Zugriff auf die Artifact Registry- und Container Registry-Domains aktivieren, die jeweils *.pkg.dev und *.gcr.io entsprechen.

Weitere Informationen finden Sie unter Privaten Google-Zugriff konfigurieren > Erweiterte Netzwerkkonfiguration.

Prüfen, ob die APIs aktiviert und über VPC zugänglich sind

Wenn sich Ihr Projekt in einem VPC Service Controls-Perimeter befindet, prüfen Sie, ob die Cloud Storage API, Container Registry API und die Artifact Registry API in Ihrem Dienstperimeter über Virtual Private Cloud (VPC) zugänglich sind.

Firewallregeln aktualisieren, um ausgehenden TCP-Traffic zuzulassen

Achten Sie darauf, dass Sie in Ihrem Netzwerk ausgehenden TCP-Traffic über die Ports 80 und 443 zulassen, damit Cloud Workstations Images auf Ihre Workstation übertragen kann.

Startlogs Ihrer Compute Engine-VM auf mögliche Fehler prüfen

VMs, die von Cloud Workstations erstellt wurden, geben beim Start Debug-Logs an die serielle Konsole aus. Diese Logs können hilfreich sein, wenn beim Erstellen einer VM eine Zeitüberschreitung auftritt. VM-Namen, die für Workstations erstellt wurden, beginnen mit workstations- gefolgt von einer eindeutigen ID. Verwenden Sie den folgenden Filter, um Ihre Logs im Log-Explorer zu filtern:

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

Wenn Sie mit diesem Filter keine Logs sehen, prüfen Sie, ob Sie das Logging des seriellen Ports in Ihrem Projekt aktiviert haben. Wenn Sie in Ihrer Workstation-Konfiguration ein Dienstkonto angegeben haben, prüfen Sie, ob das Dienstkonto die Berechtigung logging.logEntries.create für das Projekt hat, damit es Logs in Cloud Logging schreiben kann. Versuchen Sie, Ihre Workstation noch einmal zu starten, nachdem Sie das Logging des seriellen Ports aktiviert und die erforderlichen Berechtigungen hinzugefügt haben, damit das Startskript der Compute Engine-VM noch einmal ausgeführt wird, um die Logs zu generieren.

Compute Engine API-Logs auf mögliche Fehler prüfen

Wenden Sie den folgenden Filter auf Ihre Stackdriver-Logs an:

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

Fehler in der Compute Engine API können die Erstellung Ihrer Workstation-VMs verhindern.

Gastattribute in Ihrem Projekt aktivieren

Achten Sie darauf, dass Sie Gastattribute für Ihr Projekt nicht deaktiviert haben, um die Fehlerbehebung zu erleichtern. Cloud Workstations verwendet diese Attribute, um bestimmte Probleme zu erkennen, wenn Sie eine Workstation starten, und meldet diese Probleme als spezifische Debug-Meldungen in der Workstation-Konfiguration.

Beendete Workstations debuggen

Wenn Ihre Workstations unerwartet beendet werden, prüfen Sie die Plattformlogs oder die Container-Ausgabelogs, um die Ursache zu ermitteln. Diese Logs können helfen, Fehler beim Starten der Workstation, abrupte Beendigungen oder allgemeine Fehler zu identifizieren.

Gleichzeitige Beendigung von Workstations bei Verwendung von CMEK

Wenn alle Ihre Workstations gleichzeitig heruntergefahren werden und Ihre Workstation-Konfiguration vom Kunden verwaltete Verschlüsselungsschlüssel (Customer-Managed Encryption Keys, CMEK) verwendet, prüfen Sie, ob Sie die richtigen Berechtigungen für Ihren CMEK konfiguriert haben.

Prüfen Sie insbesondere, ob der Compute Engine-Dienst-Agent (service-PROJECT_NUMBER@compute-system.iam.gserviceaccount.com) die Rolle Cloud Key Management Service CryptoKey-Verschlüsseler/Entschlüsseler (roles/cloudkms.cryptoKeyEncrypterDecrypter) für Ihren CMEK hat. Wenn der Compute Engine-Dienst-Agent nicht die erforderlichen Berechtigungen für den Zugriff auf die Schlüssel hat, beendet Compute Engine automatisch die zugrunde liegenden VMs. Weitere Informationen finden Sie unter Workstation-Ressourcen mit CMEK verschlüsseln.