Definieren von wiederverwendbaren Updatestrategien mithilfe von Azure Kubernetes Fleet Manager

Administratoren können die Reihenfolge der Updates für flottenverwaltete Cluster steuern, indem sie eine Reihe von Phasen und Gruppen definieren. Sie können konfigurieren, wann Genehmigungen und Pausen innerhalb dieser Phasen und Gruppen auftreten sollen. Die gesamte Konfiguration kann als Updatestrategie gespeichert werden, die unabhängig von Updateausführungen oder automatischen Upgrades verwaltet werden kann, sodass Strategien nach Bedarf wiederverwendet werden können.

In diesem Artikel wird beschrieben, wie Sie Updatestrategien mithilfe von Gruppen und Stufen definieren.

Voraussetzungen

• Lesen Sie die konzeptionelle Übersicht über Flottenupdates, die eine Erläuterung von Updateausführungen, Phasen, Gruppen und Strategien enthält, auf die in diesem Handbuch verwiesen wird.

• Sie müssen eine Flottenressource mit einem oder mehreren Mitgliedsclustern haben. Falls nicht, folgen Sie dem Schnellstart, um eine Flottenressource zu erstellen und Azure Kubernetes Service-Cluster (AKS) als Mitglieder aufzunehmen.

• Legen Sie die folgenden Umgebungsvariablen fest:

  export GROUP=<resource-group>
  export FLEET=<fleet-name>
  export CLUSTERID=<aks-cluster-resource-id>
  export STRATEGY=<strategy-name>
  

• Wenn Sie den Anweisungen der Azure CLI in diesem Artikel folgen, benötigen Sie Azure CLI, Version 2.70.0 oder höher, installiert. Informationen zum Ausführen einer Installation oder eines Upgrades finden Sie unter Installieren der Azure-Befehlszeilenschnittstelle.

• Sie benötigen auch die fleet Azure CLI-Erweiterung Version 1.6.0 oder höher, die Sie installieren können, indem Sie den folgenden Befehl ausführen:

  az extension add --name fleet
  

  Führen Sie den Befehl az extension update aus, um auf die neueste Version der veröffentlichten Erweiterung zu aktualisieren:

  az extension update --name fleet
  

Auswählen von Clustern für Ihre Strategie

Es gibt zwei Möglichkeiten, um auszuwählen, welche Cluster in jeder Phase und Gruppe Ihrer Updatestrategie enthalten sind, um die Updatesequenz zu steuern:

• Mitgliedsbezeichnungen (empfohlen):Weisen Sie jedem Flottenmitglied Bezeichnungen zu und verwenden memberSelector Sie diese Bezeichnungen, um Mitglieder auszuwählen. Jedes Mitglied kann mehrere Labels haben.
• Aktualisieren von Gruppen: Weisen Sie jedem Flottenmitglied eine Updategruppe zu, und definieren Sie dann Gruppen in Ihrer Strategie, die diesen Gruppennamen entsprechen. Jedes Mitglied kann nur zu einer Gruppe gehören.

Erstellt eine Updatestrategie mithilfe von Mitgliedsauswahlen (Vorschau)

Mitgliedsbezeichnungen sind der empfohlene Ansatz zur Auswahl von Clustern in Ihren Updatestrategien, da sie mehr Flexibilität bieten. Konzeptionelle Details finden Sie unter "Gruppencluster mit Mitgliedsbezeichnungen".

Etiketten auf Mitglieds-Clustern anwenden

Bezeichnungen anwenden, wenn Mitglieds-Cluster dem Netzwerk hinzugefügt werden.

Wenden Sie Bezeichnungen auf Ihre Flottenmitglieder mithilfe des az fleet member create Befehls an. Im folgenden Beispiel werden zwei Labels auf den Mitglieds-Cluster angewendet: env=staging und tier=frontend.

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --labels "env=staging tier=frontend"

Anwenden von Etiketten auf ein bestehendes Flottenmitglied

Anwenden von Bezeichnungen auf Ihre Flottenmitglieder mithilfe des az fleet member update Befehls

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --labels "env=staging tier=frontend"

Erstellen einer Updatestrategie

Eine Updatestrategie besteht aus einer oder mehreren Phasen, in denen eine Phase eine oder mehrere Updategruppen enthalten kann.

1. Erstellen Sie eine JSON-Datei, um die Phasen und Gruppen für die Updateausführung zu definieren. Phasen werden sequenziell in der Reihenfolge ausgeführt, in der sie in der JSON-Datei angezeigt werden. Gruppen laufen in jeder Phase parallel ab. Die folgende Beispieldatei (example-labels-strategy.json) definiert eine Strategie mit zwei Stufen, memberSelector die zum Auswählen von Clustern anhand ihrer Bezeichnungen verwendet wird und optionale maxConcurrency Einstellungen enthält:

   • Die staging Phase verwendet eine Stufenebene memberSelector , um alle Cluster mit der Bezeichnung env=staging auszuwählen und eine implizite Gruppe zu erstellen.
   • Die production-Phase verwendet ein Stufen-memberSelector, um alle Cluster mit dem Label env=production vorzufiltern, und definiert dann zwei Gruppen, von denen jede ihren eigenen memberSelector hat, um Cluster nach dem tier-Label auszuwählen.

   Wenn memberSelector für eine Gruppe festgelegt wird, wird das Feld der Gruppe name nur als Anzeigebezeichner für Statusberichterstattung und Protokollierung verwendet und nicht mehr für die Aktualisierung der gruppenbasierten Auswahl von Flottenmitgliedern verwendet.

   {
       "stages": [
           {
               "name": "staging",
               "memberSelector": { "byLabel": "env=staging" },
               "maxConcurrency": "1",
               "afterStageWaitInSeconds": 600
           },
           {
               "name": "production",
               "memberSelector": { "byLabel": "env=production" },
               "maxConcurrency": "4",
               "groups": [
                   {
                       "name": "frontend",
                       "memberSelector": { "byLabel": "tier=frontend" },
                       "maxConcurrency": "3"
                   },
                   {
                       "name": "backend",
                       "memberSelector": { "byLabel": "tier=backend" },
                       "maxConcurrency": "3"
                   }
               ]
           }
       ]
   }
   

2. Erstellen Sie eine neue Updatestrategie mithilfe des Befehls az fleet updatestrategy create, wobei das --stages Flag auf den Namen Ihrer JSON-Datei festgelegt ist.

   az fleet updatestrategy create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name $STRATEGY \
    --stages example-labels-strategy.json
   

Erstellen einer Updatestrategie mithilfe von Updategruppen

Cluster können auch in Updatestrategien ausgewählt werden, indem sie einer einzelnen Updategruppe zugewiesen werden. Sie können eine Updatestrategie definieren, die diese Updategruppen Stufen zuweist. Innerhalb einer Updatephase werden Updates parallel auf jede Updategruppe angewendet. Innerhalb einer Updategruppe werden Mitgliedercluster sequenziell aktualisiert.

Zuweisen von Clustern zum Aktualisieren von Gruppen

Zuweisen zur Gruppe beim Hinzufügen eines Mitgliedsclusters zur Flotte

az fleet member create \
    --resource-group $GROUP \
    --fleet-name $FLEET \
    --name member1 \
    --member-cluster-id $CLUSTERID \
    --update-group group-1a

Zuweisen eines vorhandenen Flottenmitglieds zu einer Updategruppe

az fleet member update \
 --resource-group $GROUP \
 --fleet-name $FLEET \
 --name member1 \
 --update-group group-1

Erstellen einer Updatestrategie

Eine Updatestrategie besteht aus einer oder mehreren Phasen, in denen eine Phase eine oder mehrere Updategruppen enthalten kann.

Nächste Schritte

Sie können eine Updatestrategie als Teil eines manuellen Updatelaufs oder eines Profils für automatische Upgrades verwenden. Siehe:

• Anleitung: Aktualisieren Sie mehrere Cluster mithilfe von Azure Kubernetes Fleet Manager-Updateausführungen.
• Vorgehensweise: Hinzufügen von Genehmigungen zu Azure Kubernetes Fleet Manager Update-Strategien.
• Anleitung: Aktualisieren Sie automatisch mehrere Cluster mithilfe von Azure Kubernetes Fleet Manager.
• Häufig gestellte Fragen zu Multi-Cluster-Updates