Globale VM-Erweiterungsrichtlinien

In diesem Dokument erhalten Sie einen Überblick über globale VM-Erweiterungsrichtlinien in VM Extension Manager. Mit globalen Erweiterungsrichtlinien können Sie Erweiterungen in allen Zonen und Regionen innerhalb eines Projekts, Ordners oder einer Organisation bereitstellen und verwalten, um konsistente Flottenkonfigurationen beizubehalten, ohne zonenbezogene Richtlinien verwalten zu müssen.

Weitere Informationen zu Hierarchieebenen für Erweiterungsrichtlinien finden Sie unter Bereiche der Ressourcenhierarchie.

Das folgende Diagramm zeigt, wie globale Erweiterungsrichtlinien Erweiterungen auf VMs in verschiedenen Zonen und Regionen auf Organisations-, Ordner- und Projektebene anwenden:

Globale Erweiterungsrichtlinien auf Organisations-, Ordner- und Projektebene, die Erweiterungen auf VMs in verschiedenen Zonen anwenden.

Wie im vorherigen Diagramm dargestellt, können Sie globale Erweiterungsrichtlinien auf Organisations-, Ordner- oder Projektebene definieren. VM Extension Manager wendet jede Richtlinie auf übereinstimmende VMs in allen Zonen innerhalb dieses Hierarchiebereichs an.

Roll-out-Pläne für globale Richtlinien

Globale Richtlinien verwenden Roll-out-Pläne, um Erweiterungen in verschiedenen Zonen und Regionen bereitzustellen. Mit einem Roll-out-Plan können Sie die Reihenfolge und den Zeitpunkt von Updates festlegen, um einen schrittweisen, kontrollierten Roll-out zu ermöglichen und das Risiko weitreichender Probleme zu minimieren.

Wenn Sie eine globale Richtlinie erstellen oder aktualisieren, können Sie einen der folgenden Roll-out-Pläne angeben:

  • Langsame Einführung: Stellt Erweiterungen schrittweise über einen Standardzeitraum von fünf Tagen in allen Zonen bereit. Mit diesem Roll-out-Plan können Sie Probleme in frühen Bereitstellungsphasen erkennen und beheben, bevor sie sich auf Ihre gesamte Flotte auswirken.
  • Schnelle Einführung: Stellt Erweiterungen sofort auf allen Ziel-VMs in allen Zonen und Regionen bereit. Verwenden Sie diesen Roll-out-Plan, wenn Sie eine Erweiterung oder einen Patch schnell in Nicht-Produktionsumgebungen bereitstellen müssen.

Sie können auch benutzerdefinierte Roll-out-Pläne definieren, um die Bereitstellungswellen nach Zone oder Region und die Wartezeit zwischen den Wellen festzulegen. Weitere Informationen finden Sie im Artikel zur Methode rolloutPlans.insert.

Verhalten bei Roll-out-Konflikten

Wenn Sie eine globale Erweiterungsrichtlinie erstellen oder aktualisieren, kann es in den folgenden Situationen zu einem Konflikt mit einer vorhandenen zonalen Richtlinie kommen:

  • Beim Erstellen einer globalen Richtlinie Wenn in einer Zone bereits eine zonale Richtlinie mit demselben Namen vorhanden ist, tritt ein Namenskonflikt auf.
  • Wenn Sie eine globale Richtlinie aktualisieren. Wenn Sie eine vorhandene zonale Richtlinie unabhängig ändern, z. B. mit einem zonalen API-Aufruf, und ein nachfolgender globaler Richtlinien-Rollout versucht, diese zonale Richtlinie zu aktualisieren, tritt ein Inhaltskonflikt auf.

Um Roll-out-Konflikte zu beheben, können Sie ein Konfliktverhalten für den Roll-out angeben. Mit dieser Einstellung wird festgelegt, ob die globale Richtlinie während eines Roll-outs in Konflikt stehende zonale Richtlinien überschreibt. Sie können eines der folgenden Verhaltensweisen angeben:

  • Nicht überschreiben (Standardeinstellung): Wenn Sie kein Konfliktverhalten angeben, werden in Konflikt stehende zonale Richtlinien beim globalen Richtlinien-Roll-out nicht überschrieben. Die Konfiguration der zonalen Richtlinie hat in dieser Zone Vorrang.
  • Überschreiben. Wenn Sie das Konfliktverhalten auf overwrite festlegen, überschreibt die globale Richtlinie in Konflikt stehende zonale Richtlinien und der VM Extension Manager wendet die Konfiguration der globalen Richtlinie in dieser Zone an.

Roll-out-Konflikte und Richtlinienpriorität sind unterschiedliche Funktionen, die unabhängig voneinander funktionieren. Weitere Informationen zur Richtlinienpriorität finden Sie unter Richtlinienpriorität und Konfliktlösung.

Weitere Informationen zu den Einstellungen für Roll-out-Konflikte finden Sie im Parameter conflictBehavior der Methode globalVmExtensionPolicies.insert.

Roll-out wiederholen

Wenn Sie eine globale Erweiterungsrichtlinie aktualisieren oder löschen, startet VM Extension Manager einen neuen Roll-out, um die Änderungen gemäß dem Roll-out-Plan anzuwenden. Wenn ein Roll-out fehlschlägt oder neue Zonen verfügbar werden, können Sie den Vorgang wiederholen, indem Sie einen neuen Roll-out für dieselbe Richtlinie starten.

Wenn Sie ein Update oder einen Lösch-Rollout wiederholen, müssen Sie eine UUID (Universally Unique Identifier) im 32-stelligen Hexadezimalformat (z. B. a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8) angeben, um die Wiederholungsanfrage zu identifizieren. Sie können einen beliebigen Standard-UUID-Generator verwenden, um diesen Wert zu erstellen.

Roll-out einer Updaterichtlinie wiederholen

In der folgenden Liste werden Szenarien beschrieben, in denen Sie das Roll-out einer Updaterichtlinie möglicherweise wiederholen müssen:

  • Neue Bereiche hinzugefügt. Wenn nach dem Roll-out einer globalen Richtlinie neue Google Cloud -Zonen verfügbar werden, wendet VM Extension Manager vorhandene Richtlinien nicht automatisch auf VMs in den neuen Zonen an. Sie können das Update-Roll-out wiederholen, um die Erweiterungsrichtlinie auf VMs in diesen Zonen anzuwenden.
  • Änderungen an zonalen Richtlinien rückgängig machen Wenn Sie eine zonale Richtlinie unabhängig ändern, z. B. mit einem zonalen API-Aufruf, können Sie ein Update-Rollout mit conflictBehavior auf overwrite wiederholen. Mit dieser Einstellung wird die Konfiguration der globalen Richtlinie wieder angewendet und die Änderungen der zonalen Richtlinie werden überschrieben.
  • Unterbrochener Roll-out. Wenn ein vorheriger Roll-out vor dem Abschluss fehlschlägt, können Sie einen neuen Roll-out starten, um das Update noch einmal zu versuchen.
  • Roll-out beschleunigen Wenn ein laufender Roll-out zu langsam voranschreitet, können Sie einen neuen Roll-out mit einem FAST_ROLLOUT-Plan oder einem benutzerdefinierten Roll-out-Plan starten, um den Aktualisierungsprozess zu beschleunigen.

Weitere Informationen finden Sie im Artikel zur Methode globalVmExtensionPolicies.update unter dem Parameter retryUuid.

Roll-out einer Löschrichtlinie wiederholen

In der folgenden Liste werden Szenarien beschrieben, in denen Sie das Roll-out einer Löschrichtlinie möglicherweise wiederholen müssen:

  • Unterbrochener Roll-out. Wenn ein vorheriger Lösch-Roll-out vor dem Abschluss fehlschlägt, können Sie einen neuen Roll-out starten, um den Löschvorgang noch einmal zu versuchen.
  • Roll-out beschleunigen Wenn ein laufender Lösch-Roll-out zu langsam voranschreitet, können Sie einen neuen Roll-out mit einem FAST_ROLLOUT-Plan oder einem benutzerdefinierten Roll-out-Plan starten, um den Löschvorgang zu beschleunigen.

Weitere Informationen finden Sie im Artikel zur Methode globalVmExtensionPolicies.delete unter dem Parameter retryUuid.

Nächste Schritte