Globale VM-Erweiterungsrichtlinien

Mit globalen Erweiterungsrichtlinien können Sie Erweiterungen in mehreren Zonen und Regionen innerhalb eines Projekts verwalten. Wenn Sie eine globale Richtlinie anwenden, sorgt VM Extension Manager dafür, dass auf VMs in allen Regionen oder Zonen, die den Richtlinienkriterien entsprechen, die angegebenen Erweiterungen installiert und ausgeführt werden.

Das folgende Diagramm veranschaulicht, wie Sie mit einer globalen Erweiterungsrichtlinie Erweiterungen auf VMs in verschiedenen Zonen und Regionen in Ihrem Projekt anwenden können:

Architekturdiagramm des VM Extension Manager, in dem eine globale Richtlinie auf VMs in Zonen und Regionen angewendet wird.

Wie im obigen Diagramm dargestellt, können Sie eine globale Erweiterungsrichtlinie auf Projektebene definieren. Der VM Extension Manager wendet diese Richtlinie auf alle VMs an, die Ihren Auswahlkriterien entsprechen. Wenn Sie beispielsweise VMs mit dem Label env=prod in allen Zonen und Regionen des Projekts auswählen, wendet VM Extension Manager die von Ihnen angegebenen Erweiterungen, z. B. Ops-Agent und Extension for SAP, nur auf diese VMs an.

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

Globale Richtlinien verwenden Rollout-Pläne, um die Bereitstellung von Erweiterungen in Zonen und Regionen zu verwalten. Mit einem Rolloutplan können Sie die Bereitstellung von Erweiterungen steuern und so das Risiko weitverbreiteter Probleme minimieren. Mit einem Einführungsplan können Sie die Reihenfolge und den Zeitpunkt von Updates festlegen, um ein schrittweises und kontrolliertes Rollout zu gewährleisten.

Wenn Sie eine globale Richtlinie erstellen oder aktualisieren, können Sie einen der folgenden Einführungspläne angeben:

  • Langsamer Rollout: Bei diesem Rollout werden Erweiterungen über einen bestimmten Zeitraum hinweg schrittweise in verschiedenen Zonen bereitgestellt. Der Standardzeitraum beträgt fünf Tage. Dieser Ansatz wird empfohlen, da Sie so potenzielle Probleme bei früheren Rollouts erkennen und beheben können, bevor sie sich auf Ihre gesamte Flotte auswirken.
  • Schneller Roll‑out: Bei diesem Roll‑out werden Erweiterungen sofort auf allen Ziel-VMs in allen Zonen und Regionen bereitgestellt. Dieser Ansatz ist nützlich, 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 Bereitstellungsphasen basierend auf Zonen oder Regionen und die Wartezeit zwischen den Phasen anzugeben. 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 kommen:

  • Beim Erstellen einer globalen Richtlinie: Wenn in einer Zone bereits eine zonale Richtlinie vorhanden ist, die mit der globalen Richtlinie in Konflikt steht.
  • Beim Aktualisieren einer globalen Richtlinie: Wenn eine vorhandene zonale Richtlinie unabhängig vom Rollout der globalen Richtlinie geändert wurde, z. B. durch einen zonalen API-Aufruf.

Um diese Konflikte zu vermeiden, können Sie ein Konfliktverhalten für den Roll-out angeben. Dadurch wird festgelegt, ob die globale Richtlinie während eines Roll-outs in Konflikt stehende zonale Richtlinien überschreiben soll. Sie können eines der folgenden Verhaltensweisen angeben:

  • Nicht überschreiben (Standard): Wenn Sie kein Konfliktverhalten angeben, werden durch die globale Richtlinienbereitstellung keine in Konflikt stehenden zonalen Richtlinien überschrieben. Die Konfiguration der zonalen Richtlinie hat in dieser Zone Vorrang.
  • Überschreiben: Wenn Sie das Konfliktverhalten auf overwrite festlegen, werden in Konflikt stehende zonale Richtlinien durch die globale Richtlinie überschrieben und die Konfiguration der globalen Richtlinie wird in dieser Zone angewendet.

Weitere Informationen finden Sie im Artikel zur Methode globalVmExtensionPolicies.insert unter dem Parameter conflictBehavior.

Roll-out wiederholen

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

Rollout einer Updaterichtlinie wiederholen

In der folgenden Liste werden Szenarien beschrieben, in denen Sie möglicherweise den Roll-out einer Aktualisierungsrichtlinie noch einmal versuchen müssen:

  • Neue Zonen hinzugefügt: Wenn nach der Einführung einer globalen Richtlinie neue Google Cloud Zonen verfügbar werden, wendet VM Extension Manager vorhandene Richtlinien nicht automatisch auf die VMs in der neuen Zone an. Sie können den Update-Roll-out noch einmal versuchen, um die Erweiterungsrichtlinie auf VMs in den neuen Zonen anzuwenden.
  • Zonale Richtlinienänderungen rückgängig machen: Wenn zonale Richtlinien unabhängig voneinander geändert wurden, z. B. durch einen zonalen API-Aufruf, können Sie einen Update-Roll-out mit conflictBehavior auf overwrite wiederholen, um die Konfiguration der globalen Richtlinie noch einmal anzuwenden und die Änderungen an der zonalen Richtlinie zu überschreiben.
  • Unterbrochener Rollout: Wenn ein vorheriger Rollout vor dem Abschluss fehlschlägt, können Sie einen neuen Rollout starten, um die Aktualisierung noch einmal zu versuchen.
  • Rollout beschleunigen: Wenn ein laufender Rollout zu langsam voranschreitet, können Sie einen neuen Rollout mit einem FAST_ROLLOUT-Plan oder einem benutzerdefinierten Rollout-Plan starten, um den Updateprozess zu beschleunigen.

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

Wenn Sie einen Roll-out noch einmal versuchen, müssen Sie eine UUID (Universally Unique Identifier) angeben, um die Anfrage für den erneuten Versuch zu identifizieren. Sie können einen beliebigen UUID-Generator verwenden, um eine UUID zu erstellen. Die UUID muss das 32‑stellige hexadezimale Format haben, z. B. a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8.

Rollout einer Löschrichtlinie noch einmal versuchen

In der folgenden Liste werden Szenarien beschrieben, in denen Sie einen Roll-out möglicherweise noch einmal versuchen müssen, um eine Richtlinie zu löschen:

  • Unterbrochener Roll-out: Wenn ein vorheriger Roll-out zum Löschen einer Richtlinie unterbrochen wurde oder nicht erfolgreich abgeschlossen wurde, können Sie einen neuen Roll-out starten, um den Löschvorgang noch einmal zu versuchen.
  • Roll-out beschleunigen: Wenn ein laufender Roll-out zum Löschen 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

Weitere Informationen zum Verwalten von Erweiterungen finden Sie in den folgenden Ressourcen: