Fehlerbehebung bei Cloud Workstations

Diese Seite enthält Informationen zur Fehlerbehebung, die Ihnen bei der Lösung von Problemen mit Cloud Workstations helfen können.

System-Images auf VMs abrufen

Wenn Sie Workstations mit Ihrer Workstation-Konfiguration erstellen, ruft Cloud Workstations System-Images aus der Artifact Registry (oder Container Registry) auf Ihre VM-Instanz ab. Die 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 bei der Bereitstellung der VM

Wenn Sie Workstations mit Ihrer Workstation-Konfiguration erstellen, erstellt Cloud Workstations eine Compute Engine-Instanz, um Ihre Workstation zu sichern. Wenn bei der Bereitstellung Ihrer VMs ein Fehler auftritt, wird eine Fehlermeldung wie die folgende angezeigt:

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, verwenden Sie eine der folgenden Optionen:

  • Richten Sie Cloud NAT ein, damit Cloud Workstations Images auf Ihre Workstation-VMs übertragen kann.
  • Aktivieren Sie den privaten Google-Zugriff für Ihr Subnetz. Wenn Sie die Domainnamen private.googleapis.com oder restricted.googleapis.com verwenden, müssen Sie DNS-Einträge erstellen, um den Traffic an die diesen Domains zugewiesenen IP-Adressen weiterzuleiten. Insbesondere müssen Sie den Zugriff auf die Artifact Registry- und Container Registry-Domains aktivieren, die *.pkg.dev bzw. *.gcr.io entsprechen.

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

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

Wenn sich Ihr Projekt innerhalb eines VPC Service Controls-Perimeters befindet, müssen die Cloud Storage API, die Container Registry API und die Artifact Registry API in Ihrem Dienstperimeter über Virtual Private Cloud (VPC) zugänglich sein.

Firewallregeln aktualisieren, um ausgehenden TCP-Traffic zuzulassen

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

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

Von Cloud Workstations erstellte VMs geben beim Start Debugging-Logs an die serielle Konsole aus. Diese Logs können hilfreich sein, wenn der Dienst beim Erstellen einer VM eine Zeitüberschreitung meldet. VM-Namen, die für Workstations erstellt werden, beginnen mit workstations-, gefolgt von einer eindeutigen Kennung. 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 serieller Ports in Ihrem Projekt aktiviert haben. Wenn Sie in Ihrer Arbeitsstationskonfiguration ein Dienstkonto angegeben haben, muss das Dienstkonto die Berechtigung logging.logEntries.create für das Projekt haben, damit es Logs in Cloud Logging schreiben kann. Versuchen Sie, Ihre Workstation noch einmal zu starten, nachdem Sie das Logging für den seriellen Port aktiviert und die erforderlichen Berechtigungen hinzugefügt haben, damit das Compute Engine-VM-Startskript noch einmal ausgeführt wird, um die Logs zu generieren.

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

Verwenden Sie den folgenden Filter für Ihre Stackdriver-Logs:

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

Compute Engine API-Fehler können die Erstellung Ihrer Workstation-VMs blockieren.

Gastattribute für Ihr Projekt aktivieren

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

Zeitweise auftretende Backend-Weiterleitungsfehler

Wenn beim Starten einer Workstation gelegentlich der Fehler „Anfrage kann nicht an ein Backend weitergeleitet werden“ angezeigt wird, ist der Webserver der Workstation möglicherweise noch nicht vollständig gestartet.

Fügen Sie Ihrer Workstation-Konfiguration Bereitschaftsprüfungen hinzu, um dieses Problem zu beheben. Eine Bereitschaftsprüfung verhindert, dass die Workstation meldet, dass sie gestartet wurde, bis der Server am angegebenen Port bereit ist, Anfragen anzunehmen.

Beendete Workstations debuggen

Wenn Ihre Arbeitsstationen unerwartet beendet werden, prüfen Sie die Plattformlogs oder die Containerausgabelogs, um die Ursache zu ermitteln. Diese Logs können dabei helfen, Startfehler, abrupte Herunterfahrvorgänge oder allgemeine Fehler bei Workstations zu identifizieren.

Gleichzeitiges Herunterfahren von Workstations bei Verwendung von CMEK

Wenn alle Ihre Workstations gleichzeitig heruntergefahren werden und Ihre Workstation-Konfiguration kundenverwaltete Verschlüsselungsschlüssel (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.) 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, fährt Compute Engine die zugrunde liegenden VMs automatisch herunter. Weitere Informationen finden Sie unter Arbeitsstationsressourcen mit CMEK verschlüsseln.