Upgrade von Anthos im Wartemodus ausführen

Auf dieser Seite wird erläutert, wie Sie ein Upgrade von Anthos im Wartemodus durchführen.

Administratorcluster und Anthos Management Center aktualisieren

Infrastrukturbetreiber können den Administratorcluster sowie das Management Center und seine Komponenten aktualisieren.

Versionsunterstützung

Anthos, das im getrennten Modus ausgeführt wird, unterliegt jetzt einer Einstellungsrichtlinie für Versionen von Anthos Config Management und Anthos Service Mesh. Jede Version hat eine von vier Statuskategorien:

Unterstützt: Diese Version wird von Anthos im getrennten Modus erkannt und kann installiert werden. Sie funktioniert in der aktuellen Anthos-Clusterversion im getrennten Modus. Unterstützte Versionen werden wahrscheinlich in der nächsten Nebenversion von Anthos im getrennten Modus verworfen.
Verworfen: Diese Version wird von Anthos im getrennten Modus erkannt und kann installiert werden. Sie funktioniert in der aktuellen Anthos-Clusterversion im getrennten Modus. Verworfene Versionen werden in der nächsten Nebenversion von Anthos im getrennten Modus nicht mehr unterstützt.
Nicht unterstützt: Diese Version wird von der Anthos-Installation, die in der Installation des getrennten Modus ausgeführt wird, weiterhin erkannt, kann aber nicht mehr installiert werden. Er funktioniert möglicherweise nicht in der aktuellen Anthos-Version, die im Clustermodus ausgeführt wird. Es ist noch möglich, eine nicht unterstützte Version zu entfernen oder auf eine neuere Version zu aktualisieren. Nicht unterstützte Versionen werden im nächsten Neben-Anthos entfernt, das im Releasemodus im getrennten Modus ausgeführt wird.
Entfernt: Diese Version wird von der Anthos-Installation, die bei einer Installation im getrennten Modus ausgeführt wird, nicht erkannt. Es kann kein Upgrade auf eine neuere Version durchgeführt und nicht automatisch deinstalliert werden.

Der Lebenszyklus jeder Anthos Config Management- und Anthos Service Mesh-Version folgt dem Muster des Wechsels von "Unterstützt" zu "Verworfen" zu "Nicht unterstützt" zu "Entfernt".

Die folgende Tabelle zeigt die Einstellungsrichtlinie der Versionen von Anthos Config Management und Anthos Service Mesh.

Anthos im Wartemodus 1.12	Unterstützt	Verworfen	Nicht unterstützt	Entfernt
Anthos Config Management	1.12.0	1.11.1	1.10.*	1.8.,1.9.
Anthos Service Mesh	1.12.7-asm.2	1.11.*	1.10.*	1.9.*

Umgebung vorbereiten

Führen Sie die folgenden Befehle aus, um die neue Version herunterzuladen und Ausführungsberechtigungen festzulegen:

cd ~/
# Download the script which helps download all the latest components
export VERSION=UPGRADE_VERSION

# Please use official 'INSTALLER_DIGEST' value from https://cloud.google.com/anthos/private-mode/docs/1.9/installing/infrastructure#download
export INSTALLER_DIGEST=
export INSTALLER=get-anthos-private-mode-$VERSION.sh
gsutil cp gs://anthos-private-mode-release/$VERSION/$INSTALLER .
if [[ -n "$INSTALLER_DIGEST" ]]; then echo "$INSTALLER_DIGEST $INSTALLER" | sha256sum -c; fi && chmod +x $INSTALLER && ./$INSTALLER

# Note: ~/anthos-baremetal-private-mode should point to the new version.
ls -al anthos-baremetal-private-mode
cd ~/anthos-baremetal-private-mode

Ersetzen Sie dabei UPGRADE_VERSION durch die neue Version, auf die Sie das Upgrade ausführen möchten.

Laden Sie die neuen Images mit dem folgenden Befehl in Ihre private Registry hoch: Verwenden Sie das actl aus der Version UPGRADE_VERSION.
```
actl images push --private-registry=${PRIVATE_REGISTRY} \
  --images ~/anthos-baremetal-private-mode
```
Beim Hochladen werden die Images, die bereits in der Registry vorhanden sind, automatisch übersprungen.
Laden Sie Helm-Diagramme in die Container Registry hoch.

Administratorcluster aktualisieren

Für ein Upgrade des Administratorclusters aktualisieren Sie die Konfigurationsdatei für den Administratorcluster mit den folgenden Änderungen und führen dann den Befehl actl clusters baremetal upgrade aus, um das Upgrade abzuschließen.

Aktualisieren Sie in der Administrator-YAML-Datei für die Clusterkonfiguration den Versionsstring und fügen Sie die Annotation baremetal.cluster.gke.io/private-mode: "true" hinzu.
```
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: admin
  namespace: cluster-admin
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  anthosBareMetalVersion: VERSION
```
Ersetzen Sie dabei VERSION durch die neue Anthos auf Bare-Metal-Versionsnummer.
Führen Sie den folgenden Befehl aus, um den Administratorcluster zu aktualisieren Achten Sie darauf, actl von Version UPGRADE_VERSION zu verwenden.
```
actl clusters baremetal upgrade admin --kubeconfig=ADMIN_KUBECONFIG
```

Das Upgrade kann etwa 15 bis 20 Minuten dauern, je nach Clustergröße aber auch länger.

Management Center aktualisieren

Infrastrukturbetreiber können das Management Center komplett oder durch ein Upgrade einzelner Unterkomponenten aktualisieren.

Option 1: Gesamtes Management Center aktualisieren

Infrastrukturbetreiber können alle Komponenten im Management Center aktualisieren, einschließlich des Management Centers selbst.

Prüfen Sie die Version des Management Centers, um festzustellen, ob es sich um eine ältere Version handelt:
```
kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```
Ersetzen Sie dabei ADMIN_KUBECONFIG durch den Pfad der kubeconfig-Datei für den Administratorcluster.

Optional: Führen Sie die Preflight-Prüfung für das Upgrade durch:

actl platform management-center upgrade --preflight-check-only --kubeconfig=ADMIN_KUBECONFIG

Starten Sie das Upgrade (dauert in der Regel 10 bis 15 Minuten):

actl platform management-center upgrade --kubeconfig=ADMIN_KUBECONFIG

Prüfen Sie die Version des Management Centers, um festzustellen, ob die Version aktualisiert wurde:
```
kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```

Option 2: Einzelne Komponenten aktualisieren

Infrastrukturbetreiber können die Upgrades einer bestimmten Komponente verwalten, die im Management Center ausgeführt wird. Ab Version 1.9 können drei Komponenten einzeln aktualisiert werden: der Anthos Config Management-Operator, der Anthos Service Mesh-Operator und Anthos on Bare Metal.

Nach dem Hochladen der Images in die Container Registry müssen Sie die im neuen Release übermittelten Paketspezifikationen veröffentlichen. Beispiel: Die Paketspezifikation für den Anthos Config Management-Operator und den Anthos Service Mesh-Operator finden Sie unter services/.

Wenden Sie die Paketspezifikation auf den neuen Anthos Config Management-Operator an.

kubectl apply -f ~/anthos-baremetal-private-mode/services/anthos-config-management/package-spec.yaml \
--kubeconfig=ADMIN_KUBECONFIG

Prüfen Sie den aktuellen Komponentenstatus des Anthos Config Management-Operators:

kubectl get adminoperator admin-operator \
  --kubeconfig=ADMIN_KUBECONFIG \
  -ojsonpath='{.status.components[?(@.name=="anthos-config-management")]}'

Angenommen, der Befehl ergibt die aktuelle Version 1.9.X und die aktuelle Versionseinschränkung <=1.9.X.

{"name":"anthos-config-management","version":"1.9.X","versionConstraint":"<=1.9.X"}

Aktivieren Sie die neue Version, indem Sie die Versionseinschränkungen im Administrator-Operator-Objekt bearbeiten.
```
kubectl edit AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```
Ermitteln Sie im Editor die Aktualisierungsrichtlinien unter spec.updateConfigOverride.policies und erhöhen Sie die Komponentenversionen entsprechend. Wenn spec.updateConfigOverride weggelassen wird oder ein leerer Struct-Wert ({}) vorhanden ist, fügen Sie die Richtlinie so hinzu:
```
spec:
  updateConfigOverride:
    policies:
    - name: anthos-config-management
      versionConstraint: <=1.9.Y
```

Nachdem die Überschreibung hinzugefügt wurde, wird die Änderung im Management Center übernommen, um die neuere Version des Anthos Config Management-Operators zu verwenden.

Führen Sie den folgenden Befehl aus, um die Einführung der neuen Version zu überwachen. Diese wird voraussichtlich von dem früheren 1.9.X zu 1.9.Y geändert.

kubectl get adminoperator admin-operator \
  --kubeconfig=ADMIN_KUBECONFIG \
  -ojsonpath='{.status.components[?(@.name=="anthos-config-management")].version}' \
  --watch

Nach Abschluss des Roll-outs können Plattformadministratoren den neuen Anthos Config Management-Operator über das Management Center verwenden.

Nutzercluster aktualisieren

Plattformadministratoren können Nutzercluster mit dem actl-Befehlszeilentool, mit dem Management Center oder über die API aktualisieren.

actl

Führen Sie den folgenden Befehl aus, um einen Nutzercluster zu aktualisieren:

actl clusters baremetal upgrade CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

Console

Rufen Sie in der Management Center-Konsole das Menü Dashboard auf.
Klicken Sie auf den Tab Upgrades, um alle verfügbaren Upgrades aufzurufen.
Klicken Sie für den Cluster, den Sie aktualisieren möchten, auf Upgrades anzeigen.
Klicken Sie auf Upgrade, um die Details des Upgrades aufzurufen, z. B. die Version, die Beschreibung und einen Link zu den Versionshinweisen.
Klicken Sie zur Bestätigung auf Weiter.
Klicken Sie auf Upgrade, um das Upgrade des Clusters zu starten.

Im Eintrag der Upgradeliste wird Upgrade in progress angezeigt, bis das Upgrade abgeschlossen ist.

API

Sie können einen Nutzercluster aktualisieren und dafür den Versionsstring in der Cluster-Ressource ändern.

Führen Sie den folgenden Befehl aus, um die Ressource Cluster für einen Nutzercluster zu bearbeiten.
```
kubectl edit cluster CLUSTER_NAME -n cluster-CLUSTER_NAME --kubeconfig=ADMIN_KUBECONFIG
```

Aktualisieren Sie den Versionsstring in spec.anthosBareMetalVersion. Die Controller funktionieren dann mit den Upgrades.

apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: CLUSTER_NAME
  namespace: cluster-CLUSTER_NAME
  annotations:
    baremetal.cluster.gke.io/private-mode: "true"
spec:
  type: user
  anthosBareMetalVersion: VERSION

Ersetzen Sie dabei VERSION durch die neue Anthos auf Bare-Metal-Versionsnummer.

Weitere Informationen

Mehr über die Installation von Anthos Management Center erfahren