In diesem Dokument wird beschrieben, wie der Ops-Agent automatisch über die Google Cloud Konsole installiert werden kann, wenn Sie eine VM-Instanz erstellen. Während der Installation erstellt der VM Manager von Compute Engine eine Ops-Agent-Betriebssystemrichtlinie, mit der der Agent installiert und bei Bedarf neu installiert wird. Mit dem VM Manager können Sie den Ops-Agent auf Ihrer VM ausführen und dafür sorgen, dass der Agent immer installiert ist.
Übersicht
VM Manager verwendet Betriebssystemrichtlinien, um die Ops-Agent-Installation zu verwalten. Eine Konfigurationsrichtlinie wird auf eine VM angewendet, indem eine Zuordnung verwendet wird, die als Zuweisungs-ID bezeichnet wird und wie im folgenden Beispiel aussieht:
goog-ops-agent-v2-x86-template-1-0-0-ZONE
Eine Zuweisungs-ID für eine Ops-Agent-Betriebssystemrichtlinie besteht aus den folgenden Komponenten:
- Der Name der Richtlinie: „goog-ops-agent“
- Eine Vorlage zum Erstellen der Richtlinie: „v2-x86-template“
- Ein Versionsstring für die Vorlage. Die Version, die sich im Laufe der Zeit ändern kann, ist ein Wert wie „1-0-0“.
- Zone, für die die Zuweisungs-ID gilt, z. B. "us-central1-a".
Eine VM wird einer Zuweisungs-ID über die Labels der VM-Instanz zugeordnet.
Eine Compute Engine-VM ist eine überwachte Ressource vom Typ gce_instance und enthält ein zone-Label. Wenn Sie die Google Cloud -Konsole verwenden, um eine VM mit installiertem Ops-Agent zu erstellen, fügt der VM Manager der VM ein weiteres Label hinzu, das so aussieht: goog-ops-agent-policy:v2-x86-template-1-0-0. Dieses Label gibt die Richtlinie, die Vorlage und die Version an:
- Label-Schlüssel, die Kennung für die Richtlinie:
goog-ops-agent-policy - Labelwert, Richtlinienvorlage und ‑version:
v2-x86-template-1-0-0
Wenn Sie eine VM in der Google Cloud Console erstellen, können Sie das Kästchen Ops-Agent für Monitoring und Logging installieren auswählen. Wenn Sie auf Erstellen klicken, weist VM Manager der VM das Label goog-ops-agent-policy:v2-x86-template-1-0-0 zu und installiert den Ops-Agent. Wenn die VM die erste VM in ihrer Zone ist, erstellt VM Manager auch eine Ops-Agent-Betriebssystemrichtlinie und eine Zuweisung von Ops-Agent-Betriebssystemrichtlinien für diese Zone.
Solange einer Zone eine Zuweisung von Ops-Agent-Betriebssystemrichtlinien zugewiesen ist, werden VMs mit den folgenden Merkmalen von der Ops-Agent-Betriebssystemrichtlinie überwacht:
- Die VM hat das Label
goog-ops-agent-policy:v2-x86-template-1-0-0. - Die VM befindet sich in derselben Zone wie die Zuweisung der Ops-Agent-Betriebssystemrichtlinie.
Die Ops-Agent-Betriebssystemrichtlinie prüft stündlich, ob der Ops-Agent auf den abgedeckten VMs installiert ist. Wenn der Ops-Agent nicht installiert ist, wird durch die Ops-Agent-Betriebssystemrichtlinie die neueste Version des Agents installiert.
VM mit automatischer Installation des Ops-Agents erstellen
So installieren Sie den Ops-Agent während der VM-Erstellung automatisch und wenden die Zuweisung der Ops-Agent-Betriebssystemrichtlinie auf die VM an:
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/osconfig.osPolicyAssignmentEditorgcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
Replace the following:
PROJECT_ID: your project ID.USER_IDENTIFIER: the identifier for your user account—for example,myemail@example.com.ROLE: the IAM role that you grant to your user account.
- Folgen Sie der Anleitung unter VM-Instanz aus einem öffentlichen Image erstellen.
Bevor Sie auf Erstellen klicken, wählen Sie das Kästchen Ops-Agent für Monitoring und Logging installieren aus:
- Klicken Sie auf Erstellen.
Wenn Sie den Ops-Agent zum ersten Mal automatisch in einer Zone installieren und VM Manager für Ihr Google Cloud -Projekt nicht aktiviert ist, wird beim Erstellen der VM Folgendes ausgeführt:
- Ermöglicht den Betrieb von VM Manager im eingeschränkten Modus.
- Erstellt die Betriebssystemrichtlinie für den Ops-Agent und eine Zuweisung der Betriebssystemrichtlinie für den Ops-Agent für die Zone. Die Ops-Agent-Betriebssystemrichtlinie ist ein Feld der Richtlinienzuweisung.
- Aktiviert Patch-, Betriebssystemrichtlinien- und OS Inventory Management durch Festlegen des VM-Metadatenlabels
enable-osconfigaufTRUE. - Erstellt die VM und weist ihr das Ops-Agent-Betriebssystemrichtlinien-Label zu.
Wenn Sie eine VM erstellen und den Ops-Agent automatisch in einer Zone installieren, in der bereits eine Zuweisung der Ops-Agent-Betriebssystemrichtlinie vorhanden ist, wird die VM erstellt und ihr wird das Label der Ops-Agent-Betriebssystemrichtlinie zugewiesen.
Beispiel
Für Ihr Google Cloud Projekt sind keine Ops-Agent-OS-Richtlinienzuweisungen vorhanden. Sie erstellen zwei VMs, instance-1 und instance-2, in der Zone
us-central1-a. Anschließend erstellen Sie instance-3 und instance-4 in derus-east1-b-Zone. instance-1, instance-2 und instance-3 hatte das Kästchen Ops-Agent für Monitoring und Logging installieren bei der Erstellung ausgewählt.- Wenn Sie instance-1 erstellen, erstellt VM Manager eine Ops-Agent-Betriebssystemrichtlinie für die Zone
us-central1-aund eine Zuweisung von Betriebssystemrichtlinien mit der IDgoog-ops-agent-v2-x86-template-1-0-0-us-central1-a. VM Manager legt dann das Richtlinienlabel für instance-1 fest. - Wenn Sie instance-2 erstellen, legt VM Manager dasselbe Richtlinienlabel für instance-2 fest.
- Wenn Sie instance-3 erstellen, erstellt VM Manager eine Ops-Agent-Betriebssystemrichtlinie für die Zone
us-east1-bund eine Zuweisung von Betriebssystemrichtlinien mit der IDgoog-ops-agent-v2-x86-template-1-0-0-us-east1-b. VM Manager weist dann das Richtlinienlabel instance-3 zu.
Die Betriebssystemrichtlinien des Ops-Agents decken dann die folgenden VMs basierend auf den Zuweisungs-IDs der Betriebssystemrichtlinien des Ops-Agents ab:
ID der Zuweisung von Betriebssystemrichtlinien Abgedeckte VMs: Abgedeckte VMs goog-ops-agent-v2-x86-template-1-0-0-us-central1-a us-central1-a instance-1, instance-2 goog-ops-agent-v2-x86-template-1-0-0-us-east1-b us-east1-b instance-3 Standardmäßig ist instance-4 nicht abgedeckt, weil Sie Ops-Agent für Monitoring und Logging installieren nicht ausgewählt haben. Darum enthält es nicht das
goog-ops-agent-policy:v2-x86-template-1-0-0-Label Wenn Sie die Ops-Agent-Betriebssystemrichtlinie auch auf instance-4 anwenden möchten, lesen Sie den Abschnitt Abdeckung der Ops-Agent-Betriebssystemrichtlinie auf eine vorhandene VM ausweiten.Ops-Agent-Versionen auf VMs verwalten, die von der Betriebssystemrichtlinie des Ops-Agents abgedeckt werden
Die Ops-Agent-Betriebssystemrichtlinie aktualisiert den Ops-Agent nicht, wenn neue Versionen des Agents veröffentlicht werden. Solange auf der VM eine Version des Ops-Agents installiert ist, hat die Richtlinie keine Auswirkungen. Wenn Sie den Ops-Agent deinstallieren, erkennt die Richtlinie, dass der Ops-Agent nicht installiert ist, und installiert dann die neueste Version.
Wenn Sie Ihre VM auf die neueste Version des Ops-Agents aktualisieren möchten, deinstallieren Sie die Version, die Sie derzeit verwenden, und lassen Sie die neueste Version durch die Ops-Agent-Betriebssystemrichtlinie installieren.
Wenn Sie eine frühere Version des Ops-Agents installieren müssen, können Sie die Ops-Agent auf VMs deinstallieren, die von der Ops-Agent-Betriebssystemrichtlinie abgedeckt werden, und dann eine bestimmte Version des Agents installieren.
Fehlerbehebung
Informationen zur Fehlerbehebung bei der Installation von Agents und den Richtlinien für das Ops-Agent-Betriebssystem finden Sie unter VMs verwalten, die von der Betriebssystemrichtlinie des Ops-Agents abgedeckt werden und Agent-Diagnosetool für automatische Installationsrichtlinien.
Preise
Betriebssystemrichtlinien sind generische Tools zum Installieren von Paketen. Wenn VM Manager standardmäßig aktiviert wird, weil Sie eine VM mit automatisch installiertem Ops-Agent erstellt haben, wird VM Manager im eingeschränkten Modus aktiviert. Informationen zu VM Manager-Modi und ‑Preisen finden Sie unter Preise für VM Manager.
Nächste Schritte
Informationen zum Verwalten von VMs, die von der Betriebssystemrichtlinie des Ops-Agents abgedeckt werden, finden Sie unter VMs verwalten, die von der Betriebssystemrichtlinie des Ops-Agents abgedeckt werden.