Verwenden Sie dieses Dokument, um zu prüfen, ob VM Manager ordnungsgemäß eingerichtet ist. Informationen zum Einrichten des VM Managers finden Sie unter VM Manager einrichten.
Zur Überprüfung der Einrichtung können Sie entweder den Befehl zur Fehlerbehebung verwenden oder manuelle Prüfungen auf der VM-Instanz ausführen.
Hinweise
- Verwenden Sie für Windows-VMs PowerShell 3.0 oder höher.
-
Richten Sie die Authentifizierung ein, falls Sie dies noch nicht getan haben.
Bei der Authentifizierung wird Ihre Identität für den Zugriff auf Trusted Cloud by S3NS -Dienste und APIs überprüft.
Zum Ausführen von Code oder Beispielen aus einer lokalen Entwicklungsumgebung können Sie sich so bei der Compute Engine authentifizieren:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Installieren Sie die Google Cloud CLI und melden Sie sich dann mit Ihrer föderierten Identität in der gcloud CLI an. Nach der Anmeldung initialisieren Sie die Google Cloud CLI mit folgendem Befehl:
gcloud init
- Set a default region and zone.
Befehl zur Fehlerbehebung verwenden
Prüfen Sie die Einrichtung mit dem
os-config troubleshoot
-Befehl. Schlägt eine der Prüfungen fehl, erhalten Sie Feedback zu der Lösung des relevanten Problems.gcloud compute os-config troubleshoot VM_NAME \ --zone=ZONE
Dabei gilt:
VM_NAME
: der Name der VM-Instanz, bei der Sie eine Fehlerbehebung ausführen möchtenZONE
: die Zone, in der sich die Instanz befindet.
Beispiele
- Beispiel 1: zeigt die Ausgabe des Befehls
os-config troubleshoot
an, wenn die VM-Instanz Probleme mit der Einrichtung hat Beispiel 2: zeigt die Ausgabe für den Befehl
os-config troubleshoot
an, wenn die VM-Instanz ordnungsgemäß eingerichtet ist
Beispiel 1
Führen Sie folgenden Befehl aus, um eine Fehlerbehebung bei einer VM-Instanz namens
my-instance-1
in der Zoneasia-east2-b
durchzuführen:gcloud compute os-config troubleshoot my-instance-1 \ --zone=asia-east2-b
Die Ausgabe sollte so aussehen:
OS Config troubleshooter tool is checking if there are issues with the VM Manager setup for this VM instance. > Is the OS Config API enabled? Yes > Is the OS Config agent enabled? Yes > Is the OS Config agent up to date? No The version of OS Config agent running on this VM instance is not the latest version. See https://cloud.google.com/compute/docs/manage-os/upgrade-vm-manager#update-agent on how to update the agent.
Beispiel 2
Führen Sie folgenden Befehl aus, um eine Fehlerbehebung bei einer VM-Instanz namens
my-instance-2
in der Zoneus-west1-b
durchzuführen:gcloud compute os-config troubleshoot my-instance-2 \ --zone=us-west1-b
Die Ausgabe sollte so aussehen:
OS Config troubleshooter tool is checking if there are issues with the VM Manager setup for this VM instance. > Is the OS Config API enabled? Yes > Is the OS Config agent enabled? Yes > Is the OS Config agent up to date? Yes > Is a service account present on the instance? Yes > Is the OS Config Service account present for this instance? Yes > Does this instance have a public IP or Private Google Access? Yes This instance has a public IP.
Manuelle Bestätigung
Führen Sie die folgenden Prüfungen durch, um zu prüfen, ob VM Manager ordnungsgemäß eingerichtet ist:
- OS Config API aktiviert
- OS Config-Metadaten sind aktiviert
- OS Config-Agent ist installiert und wird ausgeführt
- Dienstkonto ist aktiviert
- VM kann mit der OS Config API kommunizieren
Wenn VM Manager ordnungsgemäß eingerichtet ist, aber weiterhin Probleme auftreten, finden Sie weitere Informationen unter Fehlerbehebung bei VM Manager.
Prüfen, ob OS Config API aktiviert ist
Prüfen Sie in Ihrem Trusted Cloud -Projekt, ob die API aktiviert ist.
Console
Rufen Sie in der Trusted Cloud Console die Seite OS Config API auf.
gcloud
gcloud services list --enabled
Wenn die API aktiviert ist, sieht die Ausgabe in etwa so aus:
osconfig.googleapis.com OS Config API
Wenn die API nicht aktiviert ist, aktivieren Sie die OS Config API.
Prüfen, ob Metadaten aktiviert sind
Linux
Führen Sie für Projektmetadaten auf der VM die folgenden Schritte aus:
Fragen Sie den Endpunkt der Projektattribute ab:
curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/" \ -H "Metadata-Flavor: Google"
Wenn der Metadatenwert des Agents festgelegt wurde, sieht die Ausgabe in etwa so aus:
enable-osconfig
Wenn der Wert
enable-osconfig
angezeigt wird, fragen Sie den Endpunkt ab:curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig" \ -H "Metadata-Flavor: Google"
Bei Aktivierung gibt der Endpunkt
TRUE
zurück.
Wenn die Metadaten nicht aktiviert sind, aktivieren Sie die OS Config-Metadaten.
Windows
Öffnen Sie für Projektmetadaten auf einer VM ein PowerShell-Terminal als Administrator und führen Sie den folgenden Befehl aus:
Fragen Sie den Endpunkt der Projektattribute ab:
$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/") $value
Wenn der Metadatenwert des Agents festgelegt wurde, sieht die Ausgabe in etwa so aus:
enable-osconfig
Wenn der Wert
enable-osconfig
angezeigt wird, fragen Sie den Endpunkt ab:$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig") $value
Bei Aktivierung gibt der Endpunkt
TRUE
zurück.
Wenn die Metadaten nicht aktiviert sind, aktivieren Sie die OS Config-Metadaten.
Prüfen, ob der OS Config-Agent installiert ist und ausgeführt wird
Linux
Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Agent auf Ihrer Linux-VM installiert ist:
sudo systemctl status google-osconfig-agent
Wenn der Agent installiert ist und ausgeführt wird, sieht die Ausgabe in etwa so aus:
google-osconfig-agent.service - Google OSConfig Agent Loaded: loaded (/lib/systemd/system/google-osconfig-agent.service; enabled; vendor preset: Active: active (running) since Wed 2020-01-15 00:14:22 UTC; 6min ago Main PID: 369 (google_osconfig) Tasks: 8 (limit: 4374) Memory: 102.7M CGroup: /system.slice/google-osconfig-agent.service └─369 /usr/bin/google_osconfig_agent
Wenn der Agent nicht installiert ist, installieren Sie den OS Config-Agent.
Windows
Führen Sie den folgenden Befehl aus, um zu prüfen, ob der Agent auf Ihrer Windows-VM installiert ist:
PowerShell Get-Service google_osconfig_agent
Wenn der Agent installiert ist und ausgeführt wird, sieht die Ausgabe in etwa so aus:
Status Name DisplayName ------ ---- ----------- Running google_osconfig... Google OSConfig Agent
Wenn der Agent nicht installiert ist, installieren Sie den OS Config-Agent.
Prüfen, ob das Dienstkonto aktiviert ist
Informationen zu den Anforderungen des Dienstkontos finden Sie unter Übersicht zur Einrichtung.
Linux
Führen Sie auf der VM folgenden Befehl aus:
curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" \ -H "Metadata-Flavor: Google"
Die Ausgabe sollte mindestens das Standarddienstkonto enthalten.
default/
Windows
Öffnen Sie auf der VM ein PowerShell-Terminal als Administrator und führen Sie den folgenden Befehl aus:
$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/") $value
Die Ausgabe sollte mindestens das Standarddienstkonto enthalten.
default/
Prüfen, ob die VM mit der OS Config API kommunizieren kann
Führen Sie den folgenden Befehl auf Ihrer Linux- oder Windows-VM aus, um zu prüfen, ob die VM mit der OS Config API kommunizieren kann:
ping osconfig.googleapis.com
Zum Beenden des Pingens der OS Config API drücken Sie Strg + C.
Wenn Ihre VM in einem privaten VPC-Netzwerk ausgeführt wird und keinen öffentlichen Internetzugang hat, prüfen Sie, ob der private Google-Zugriff aktiviert ist.
Nachdem Sie den privaten Google-Zugriff aktiviert haben, prüfen Sie, ob die VM mit der OS Config API kommunizieren kann.
Linux
Führen Sie auf der VM folgenden Befehl aus:
curl --ssl 'https://osconfig.googleapis.com/$discovery/rest' | head
Wenn die VM mit der OS Config API kommunizieren kann, sieht die Befehlsausgabe in etwa so aus:
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0{ "discoveryVersion": "v1", "baseUrl": "https://osconfig.googleapis.com/", "ownerName": "Google", "version": "v1beta", "schemas": { "GooSettings": { "description": "Googet patching is performed by running `googet update`.", "properties": {}, "id": "GooSettings", 100 9569 0 9569 0 0 198k 0 --:--:-- --:--:-- --:--:-- 198k
Windows
Öffnen Sie auf der VM ein PowerShell-Terminal als Administrator und führen Sie Folgendes aus:
Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'} -Uri 'https://osconfig.googleapis.com/$discovery/rest'
Nächste Schritte
- Betriebssystemdetails ansehen
- Zuweisung von Betriebssystemrichtlinien erstellen.
- Patchjobs erstellen
- Fehlerbehebung bei VM Manager
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-08 (UTC).
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-08 (UTC)."],[[["This document provides methods to verify that VM Manager is properly set up, including using the `os-config troubleshoot` command or performing manual checks on the VM instance."],["Before using the verification methods, you may need to set up authentication, and for Windows VMs, PowerShell 3.0 or later is required."],["The `os-config troubleshoot` command is used with a specific VM name and zone to check for setup issues, and if any problems are detected, feedback is provided on how to resolve them."],["Manual verification involves checking if the OS Config API is enabled, OS Config metadata is enabled, the OS Config agent is installed and running, the service account is enabled, and the VM can communicate with the OS Config API."],["If VM Manager is correctly set up but issues still arise, further troubleshooting steps are available in the linked \"Troubleshooting VM Manager\" document."]]],[]] -