Privaten Anthos-Modus aktualisieren

Auf dieser Seite wird erläutert, wie Sie ein Upgrade für den privaten Modus von Anthos ausführen.

Administratorcluster und Anthos Management Center aktualisieren

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

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.8/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.

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 YAML-Datei für die Administratorclusterkonfiguration den Versionsstring.
```
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: admin
  namespace: cluster-admin
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.8 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.8.X und die aktuelle Versionseinschränkung <=1.8.X.

{"name":"anthos-config-management","version":"1.8.X","versionConstraint":"<=1.8.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.8.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.8.X zu 1.8.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
spec:
  type: user
  anthosBareMetalVersion: VERSION
```
Ersetzen Sie dabei VERSION durch die neue Anthos auf Bare-Metal-Versionsnummer.