Upgrade für einen Administrator- oder Nutzercluster mit Anthos On-Prem API-Clients ausführen

Auf dieser Seite wird erläutert, wie Sie mit der Google Cloud Console oder der Google Cloud CLI ein Administrator- oder Nutzercluster upgraden, der von der Anthos On-Prem API verwaltet wird. Bevor Sie fortfahren, lesen Sie die Best Practices für das Upgrade und den Lebenszyklus und Phasen von Clusterupgrades, um Informationen zu Upgradeanforderungen, Best Practices und zusätzlichen Informationen zum Upgradeprozess zu erhalten.

Was ist die Anthos On-Prem-API?

Die Anthos On-Prem API ist eine von Google Cloud gehostete API, mit der Sie den Lebenszyklus Ihrer lokalen Nutzercluster mithilfe von Google Cloud-Standardanwendungen verwalten können. Die Anthos On-Prem API wird in der Infrastruktur von Google Cloud ausgeführt. Die Google Cloud Console und die gcloud CLI sind Clients der API und verwenden die API zum Erstellen, Aktualisieren, Aktualisieren und Löschen von Clustern in Ihrem Rechenzentrum. Wenn Sie den Cluster mit bmctl erstellt haben, können Sie den Cluster so konfigurieren, dass er von der Anthos On-Prem API verwaltet wird, sodass Sie die Standardclients verwenden können.

Hinweis

Befehlszeilentools installieren

Wenn Sie das Cluster über die gcloud CLI upgraden oder das Connect-Gateway zum Ausführen von kubectl-Befehlen auf Ihrem lokalen Computer verwenden möchten (im Gegensatz zur Administrator-Workstation), müssen Sie die folgenden Befehlszeilentools installiert haben:

Die neueste Version der gcloud CLI.
kubectl zum Ausführen von Befehlen für Kubernetes-Cluster. Falls Sie kubectl installieren müssen, folgen Sie dieser Anleitung.

IAM-Anforderungen

Wenn Sie kein Projektinhaber sind, benötigen Sie die Rolle roles/gkeonprem.admin für die Identitäts- und Zugriffsverwaltung des Google Cloud-Projekts, in dem der Nutzercluster erstellt wurde. Ausführliche Informationen zu den in dieser Rolle enthaltenen Berechtigungen finden Sie in der IAM-Dokumentation unter GKE On-Prem-Rollen.

Wenn Sie den Cluster über die Console aktualisieren möchten, benötigen Sie mindestens Folgendes:

roles/container.viewer: Mit dieser Rolle können Nutzer die Seite „GKE-Cluster“ und andere Containerressourcen in der Console aufrufen. Ausführliche Informationen zu den in dieser Rolle enthaltenen Berechtigungen oder zum Gewähren einer Rolle mit Lese-/Schreibberechtigungen finden Sie in der IAM-Dokumentation unter Kubernetes Engine-Rollen.
roles/gkehub.viewer: Mit dieser Rolle können Nutzer Cluster in der Console ansehen. Ausführliche Informationen zu den in dieser Rolle enthaltenen Berechtigungen oder zum Gewähren einer Rolle mit Lese-/Schreibberechtigungen finden Sie in der IAM-Dokumentation unter GKE-Hub-Rollen.

Versionsanforderungen

Sie können direkt ein Upgrade auf eine Version ausführen, die in der gleichen Nebenversion oder in der nächsten Nebenversion enthalten ist. Sie können beispielsweise ein Upgrade von 1.14.1 auf 1.14.2 oder von 1.13.1 auf 1.14.1 ausführen. Ein Upgrade auf eine Version, die mehr als eine Nebenversion höher als die installierte Version ist, ist nicht zulässig.

Ein Administratorcluster kann Nutzercluster verwalten, die sich in der gleichen oder einer früheren Nebenversion befinden. Verwaltete Nutzercluster dürfen nicht kleiner als eine Nebenversion sein.

Beachten Sie die folgenden Beschränkungen:

Nur Nutzercluster der Version 1.13.1 oder höher können über die Console oder die gcloud CLI aktualisiert werden. Wenn der Nutzercluster 1.13.0 oder niedriger ist, führen Sie ein Upgrade des Clusters mit bmctl durch.
Sie müssen ein Administratorcluster upgraden, bevor Sie ein Upgrade für verknüpfte Nutzercluster durchführen. Prüfen Sie jedoch vor dem Upgrade des Administratorclusters auf 1.14.3, ob die zugehörigen Nutzercluster die Version 1.13.1 oder höher haben.

Administratorcluster upgraden

Console

Rufen Sie in der Console die Seite "Anthos-Cluster" auf.

Zur Seite "Anthos-Cluster"
Wählen Sie das Cloud-Projekt und dann den Cluster aus, den Sie upgraden möchten.
Klicken Sie im Bereich Details auf Weitere Details.
Klicken Sie im Abschnitt Clustergrundlagen auf Upgrade.
Wählen Sie in der Liste Zielversion auswählen die Version aus, auf die Sie ein Upgrade ausführen möchten. Wir empfehlen ein Upgrade auf die neueste Patchversion.
Klicken Sie auf Upgrade.

Vor dem Upgrade des Clusters werden Preflight-Prüfungen ausgeführt, um den Clusterstatus und den Knotenzustand zu validieren. Wenn die Preflight-Prüfungen erfolgreich sind, wird das Administratorcluster aktualisiert. Es dauert je nach Größe des Clusters 30 Minuten oder länger, bis das Upgrade abgeschlossen ist.

Klicken Sie auf dem Tab Clusterdetails auf Details anzeigen, um den Status des Upgrades aufzurufen.

gcloud-CLI

Führen Sie den folgenden Befehl aus, um sich mit Ihrem Google-Konto anzumelden:
```
gcloud auth login
```
Aktualisieren Sie die Google Cloud CLI-Komponenten:
```
gcloud components update
```
Eine Liste der verfügbaren Versionen für das Upgrade abrufen:
```
gcloud alpha container bare-metal admin-clusters query-version-config \
--cluster=ADMIN_CLUSTER_NAME \
--project=FLEET_HOST_PROJECT_ID \
--location=REGION
```
Dabei gilt:
- ADMIN_CLUSTER_NAME: Der Name des Administratorclusters.
- FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, zu dem dieser Administratorcluster gehört. Dies ist die Projekt-ID, die Sie beim Erstellen des Clusters im Feld gkeConnect.projectID in der Clusterkonfigurationsdatei angegeben haben.
- REGION: Die Google Cloud-Region, in der die Anthos On-Prem API ausgeführt wird und die Metadaten speichert. Dies ist die Region, die Sie beim Registrieren des Clusters für die Verwaltung mit der Anthos On-Prem API ausgewählt haben.
Cluster upgraden:
```
gcloud alpha container bare-metal admin-clusters update ADMIN_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION \
  --version=VERSION
```
Dabei gilt:
- ADMIN_CLUSTER_NAME: Der Name des Administratorclusters, der aktualisiert werden soll.
- FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, zu dem dieser Administratorcluster gehört. Dies ist die Projekt-ID, die Sie beim Erstellen des Clusters im Feld gkeConnect.projectID in der Clusterkonfigurationsdatei angegeben haben.
- REGION: Die Google Cloud-Region, in der die Anthos On-Prem API ausgeführt wird und die Metadaten speichert. Dies ist die Region, die Sie beim Registrieren des Clusters für die Verwaltung mit der Anthos On-Prem API ausgewählt haben.
- VERSION: Die Anthos-Cluster auf Bare-Metal-Version, auf die Sie ein Upgrade ausführen möchten. r>' }}`: Die Anthos-Cluster auf Bare-Metal-Version, auf die Sie ein Upgrade ausführen möchten. Geben Sie eine Version aus der Ausgabe des vorherigen Befehls an. Wir empfehlen ein Upgrade auf die neueste Patchversion.
Es dauert je nach Größe des Clusters 30 Minuten oder länger, bis das Upgrade abgeschlossen ist.
Führen Sie während des Upgrades des Clusters den folgenden Befehl in einem anderen Terminalfenster aus, um den Status des Clusters zu prüfen:
```
gcloud alpha container bare-metal admin-clusters describe ADMIN_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION
```

Weitere Informationen zu den Feldern und Flags finden Sie in der Referenz zu gcloud alpha container bare-metal admin-clusters.

Nutzercluster aktualisieren

Console

Rufen Sie in der Console die Seite "Anthos-Cluster" auf.

Zur Seite "Anthos-Cluster"
Wählen Sie das Cloud-Projekt und dann den Cluster aus, den Sie upgraden möchten.
Klicken Sie im Bereich Details auf Weitere Details.
Klicken Sie im Abschnitt Clustergrundlagen auf Upgrade.
Wählen Sie in der Liste Zielversion auswählen die Version aus, auf die Sie ein Upgrade ausführen möchten. Die ausgewählte Liste enthält nur die neuesten Patchreleases.
Klicken Sie auf Upgrade.

Vor dem Upgrade des Clusters werden Preflight-Prüfungen ausgeführt, um den Clusterstatus und den Knotenzustand zu validieren. Wenn die Preflight-Prüfungen bestanden sind, wird ein Upgrade für den Nutzercluster durchgeführt. Es dauert je nach Größe des Clusters 30 Minuten oder länger, bis das Upgrade abgeschlossen ist.

Klicken Sie auf dem Tab Clusterdetails auf Details anzeigen, um den Status des Upgrades aufzurufen.

gcloud-CLI

Führen Sie den folgenden Befehl aus, um sich mit Ihrem Google-Konto anzumelden:
```
gcloud auth login
```
Aktualisieren Sie die Google Cloud CLI-Komponenten:
```
gcloud components update
```
Eine Liste der verfügbaren Versionen für das Upgrade abrufen:
```
gcloud alpha container bare-metal clusters query-version-config \
--cluster=USER_CLUSTER_NAME \
--project=FLEET_HOST_PROJECT_ID \
--location=REGION
```
Dabei gilt:
- USER_CLUSTER_NAME: Der Name des Nutzerclusters, der aktualisiert werden soll.
- FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, zu dem dieser Nutzercluster gehört. Dies ist das Projekt, das Sie beim Erstellen des Clusters angegeben haben. Wenn Sie den Cluster mit bmctl erstellt haben, ist dies die Projekt-ID im Feld gkeConnect.projectID in der Clusterkonfigurationsdatei.
- REGION: Die Google Cloud-Region, in der die Anthos On-Prem API ausgeführt wird und die Metadaten speichert. Wenn Sie den Cluster mit einem Anthos On-Prem API-Client erstellt haben, ist dies die Region, die Sie beim Erstellen des Clusters angegeben haben. Wenn Sie den Cluster mit bmctl erstellt haben, ist dies die Region, die Sie bei der Registrierung des Clusters für die Verwaltung mit der Anthos On-Prem API angegeben haben.
Cluster upgraden:
```
gcloud alpha container bare-metal clusters update USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION \
  --version=VERSION
```
Dabei gilt:
- USER_CLUSTER_NAME: Der Name des Nutzerclusters, der aktualisiert werden soll.
- FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, zu dem dieser Nutzercluster gehört. Dies ist das Projekt, das Sie beim Erstellen des Clusters angegeben haben. Wenn Sie den Cluster mit bmctl erstellt haben, ist dies die Projekt-ID im Feld gkeConnect.projectID in der Clusterkonfigurationsdatei.
- REGION: Die Google Cloud-Region, in der die Anthos On-Prem API ausgeführt wird und die Metadaten speichert. Wenn Sie den Cluster mit einem Anthos On-Prem API-Client erstellt haben, ist dies die Region, die Sie beim Erstellen des Clusters angegeben haben. Wenn Sie den Cluster mit bmctl erstellt haben, ist dies die Region, die Sie bei der Registrierung des Clusters für die Verwaltung mit der Anthos On-Prem API angegeben haben.
- VERSION: Die Anthos-Cluster auf Bare-Metal-Version, auf die Sie ein Upgrade ausführen möchten. Geben Sie eine Version aus der Ausgabe des vorherigen Befehls an. Wir empfehlen ein Upgrade auf die neueste Patchversion.
Es dauert je nach Größe des Clusters 30 Minuten oder länger, bis das Upgrade abgeschlossen ist.
Führen Sie während des Upgrades des Clusters den folgenden Befehl in einem anderen Terminalfenster aus, um den Status des Clusters zu prüfen:
```
gcloud alpha container bare-metal clusters describe USER_CLUSTER_NAME \
  --project=FLEET_HOST_PROJECT_ID \
  --location=REGION
```

Weitere Informationen zu den Feldern und Flags finden Sie unter gcloud alpha container bare-metalclusters reference.