Administrator- oder Nutzercluster mit Anthos On-Prem API-Clients upgraden

Version 1.13 

• Neueste
• Version 1.16
• Frühere Versionen (nicht unterstützt)

Vorschau

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Auf dieser Seite wird erläutert, wie Sie mit der Google Cloud Console oder der Google Cloud CLI einen Administrator- oder Nutzercluster upgraden, der von der Anthos On-Prem API verwaltet wird. Informationen zu den Upgradeanforderungen, Best Practices und zusätzlichen Informationen zum Upgradeprozess finden Sie unter Best Practices für Upgrades.

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. Sie 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 den Cluster über die gcloud CLI upgraden oder mit dem Connect-Gateway kubectl-Befehle auf Ihrem lokalen Computer ausführen möchten (im Gegensatz zur Administratorworkstation), müssen die folgenden Befehlszeilentools installiert sein:

• 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, muss Ihnen die Rolle roles/gkeonprem.admin für Identity and Access Management für das Google Cloud-Projekt gewährt werden, in dem der Nutzercluster erstellt wurde. Weitere 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 upgraden 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. Weitere 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. Weitere 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 auf eine Version upgraden, die sich in derselben Nebenversion oder in der nächsten Nebenversion befindet. Ein Upgrade ist beispielsweise von 1.13.1 auf 1.13.2 oder von 1.12.1 auf 1.13.1 möglich. Ein Upgrade auf eine Version, die mehr als eine Nebenversion höher ist als die installierte Version, 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 mehr als eine Nebenversion niedriger als der Administratorcluster sein.

Beachten Sie die folgenden Beschränkungen:

• Das Upgrade über die Console oder die gcloud CLI ist nur für Nutzercluster ab Version 1.13.1 möglich. Wenn Sie einen Nutzercluster mit Version 1.13.0 oder niedriger haben, führen Sie ein Upgrade des Clusters mit bmctl durch.

• Sie müssen einen Administratorcluster upgraden, bevor Sie ein Upgrade für verknüpfte Nutzercluster ausführen. Prüfen Sie jedoch vor dem Upgrade des Administratorclusters auf 1.13.7, ob die zugehörigen Nutzercluster Version 1.12.0 oder höher haben.

Administratorcluster upgraden

Achten Sie darauf, dass der Administratorcluster bei der Anthos On-Prem API registriert ist. Weitere Informationen finden Sie unter Cluster konfigurieren, der von der Anthos On-Prem API verwaltet werden soll.

Console

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

   Zur Seite "Anthos-Cluster"

2. Wählen Sie das Cloud-Projekt und dann den Cluster aus, für den Sie ein Upgrade ausführen möchten.

3. Klicken Sie im Bereich Details auf Weitere Details.

4. Klicken Sie im Abschnitt Clustergrundlagen auf Upgrade.

5. Wählen Sie in der Liste Zielversion auswählen die Version aus, auf die Sie upgraden möchten. Wir empfehlen ein Upgrade auf die neueste Patchversion.

6. Klicken Sie auf Upgrade.

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

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

gcloud-CLI

1. Führen Sie den folgenden Befehl aus, um sich mit Ihrem Google-Konto anzumelden:

   gcloud auth login
   

2. Aktualisieren Sie die Google Cloud CLI-Komponenten:

   gcloud components update
   

3. Liste der verfügbaren Versionen für das Upgrade abrufen:

   gcloud beta container bare-metal admin-clusters query-version-config \
   --cluster=ADMIN_CLUSTER_NAME \
   --project=FLEET_HOST_PROJECT_ID \
   --location=REGION
   

   Dabei gilt:

   • ADMIN_CLUSTER_NAME ist der Name des Administratorclusters.

   • FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, in dem dieser Administratorcluster Mitglied ist. 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 ihre Metadaten speichert. Dies ist die Region, die Sie bei der Registrierung des Clusters für die Verwaltung mit der Anthos On-Prem API ausgewählt haben.

4. Cluster upgraden:

   gcloud beta container bare-metal admin-clusters update ADMIN_CLUSTER_NAME \
     --project=FLEET_HOST_PROJECT_ID \
     --location=REGION \
     --version=VERSION
   

   Dabei gilt:

   • ADMIN_CLUSTER_NAME ist der Name des Administratorclusters, der aktualisiert werden soll.

   • FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, in dem dieser Administratorcluster Mitglied ist. 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 ihre Metadaten speichert. Dies ist die Region, die Sie bei der Registrierung 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. Geben Sie eine Version aus der Ausgabe des vorherigen Befehls an. Wir empfehlen ein Upgrade auf die neueste Patchversion.

   Es kann je nach Größe des Clusters 30 Minuten oder länger dauern, bis das Upgrade abgeschlossen ist.

5. 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 beta 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 beta container bare-metal admin-clusters.

Nutzercluster aktualisieren

Console

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

   Zur Seite "Anthos-Cluster"

2. Wählen Sie das Cloud-Projekt und dann den Cluster aus, für den Sie ein Upgrade ausführen möchten.

3. Klicken Sie im Bereich Details auf Weitere Details.

4. Klicken Sie im Abschnitt Clustergrundlagen auf Upgrade.

5. Wählen Sie in der Liste Zielversion auswählen die Version aus, auf die Sie upgraden möchten. Wir empfehlen ein Upgrade auf die neueste Patchversion.

6. Klicken Sie auf Upgrade.

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

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

gcloud-CLI

1. Führen Sie den folgenden Befehl aus, um sich mit Ihrem Google-Konto anzumelden:

   gcloud auth login
   

2. Aktualisieren Sie die Google Cloud CLI-Komponenten:

   gcloud components update
   

3. Liste der verfügbaren Versionen für das Upgrade abrufen:

   gcloud beta container bare-metal clusters query-version-config \
   --cluster=USER_CLUSTER_NAME \
   --project=FLEET_HOST_PROJECT_ID \
   --location=REGION
   

   Dabei gilt:

   • USER_CLUSTER_NAME ist der Name des Nutzerclusters, der aktualisiert werden soll.

   • FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, in dem der Nutzercluster Mitglied ist. 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 ihre 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.

4. Cluster upgraden:

   gcloud beta container bare-metal clusters update USER_CLUSTER_NAME \
     --project=FLEET_HOST_PROJECT_ID \
     --location=REGION \
     --version=VERSION
   

   Dabei gilt:

   • USER_CLUSTER_NAME ist der Name des Nutzerclusters, der aktualisiert werden soll.

   • FLEET_HOST_PROJECT_ID: Die ID des Flottenprojekts, in dem der Nutzercluster Mitglied ist. 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 ihre 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 kann je nach Größe des Clusters 30 Minuten oder länger dauern, bis das Upgrade abgeschlossen ist.

5. 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 beta container bare-metal clusters describe USER_CLUSTER_NAME \
     --project=FLEET_HOST_PROJECT_ID \
     --location=REGION
   

Weitere Informationen zu den Feldern und Flags finden Sie in der Referenz für gcloud Beta-Container-Bare-Metal-Cluster.