Cluster-Upgrade durchführen

In diesem Dokument wird beschrieben, wie Sie die Kubernetes-Version eines GDC-Kubernetes-Clusters (Google Distributed Cloud) mit Air Gap aktualisieren. Sie müssen routinemäßige Upgrades für Ihre Cluster planen, damit sie die neuesten Kubernetes-Features und -Fehlerkorrekturen enthalten.

Dieses Dokument richtet sich an Zielgruppen wie IT-Administratoren, Sicherheitstechniker und Netzwerkadministratoren innerhalb der Plattformadministratorgruppe, die für die Verwaltung von Kubernetes-Ressourcen in ihrer Organisation verantwortlich sind. Weitere Informationen finden Sie unter Dokumentation zu Zielgruppen für GDC mit Air Gap.

Hinweis

Zum Ausführen der Aufgaben in diesem Dokument müssen Sie die erforderlichen Berechtigungen anfordern und Ihre Umgebung vorbereiten.

IAM-Rollen anfordern

Sie benötigen bestimmte Rollen, um die Berechtigungen zu erhalten, die Sie für ein Upgrade Ihres Kubernetes-Clusters benötigen. Sie müssen Rollen anfordern, die auf Ihr Projekt und Ihre Organisation beschränkt sind.

Organisationsrollen

Bitten Sie Ihren IAM-Organisationsadministrator, Ihnen die Rolle User Cluster Admin (user-cluster-admin) zuzuweisen, um die verfügbaren Upgradeversionen für einen Kubernetes-Cluster aufzulisten. Diese Rolle ist nicht an einen Namespace gebunden.

Wenn Sie einen Standardcluster verwalten und die Rolle „User Cluster Admin“ nicht von Ihrer Plattformadministratorgruppe erhalten können, müssen Sie diese bitten, Ihnen die Liste der verfügbaren Kubernetes-Upgrade-Versionen zur Verfügung zu stellen.

Projektrollen

Bitten Sie Ihren IAM-Projektadministrator, Ihnen die Rolle Standard-Cluster-Administrator (standard-cluster-admin) zuzuweisen, um Clusterupgrades zu erstellen, zu löschen, zu bearbeiten oder anzusehen. Diese Rolle ist an Ihren Projekt-Namespace gebunden.

Umgebung vorbereiten

Wenn Sie Befehle für einen Kubernetes-Cluster über die API ausführen möchten, benötigen Sie die folgenden Ressourcen:

Kubernetes-Cluster aktualisieren

Verwenden Sie die UserClusterUpgradeRequest API, um ein Upgrade für einen vorhandenen Kubernetes-Cluster durchzuführen.

So aktualisieren Sie einen Kubernetes-Cluster mithilfe der API:

  1. Listen Sie die verfügbaren Kubernetes-Upgrade-Versionen auf, indem Sie den Wert kubernetesVersion der UserClusterMetadata-Objekte ausgeben:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
    get userclustermetadata -o=custom-columns='TARGET_VERSION:.spec.kubernetesVersion'

    Ersetzen Sie MANAGEMENT_API_SERVER durch den Pfad zur kubeconfig-Datei des Verwaltungs-API-Servers.

    Der Befehl gibt eine Liste der verfügbaren Kubernetes-Versionen zurück:

    TARGET_VERSION
1.30.1000-gke.85

  2. Notieren Sie sich die Kubernetes-Version aus der vorherigen Ausgabe, auf die Sie Ihren Cluster aktualisieren möchten. Die targetVersion, die Sie im nächsten Schritt in der Upgradeanfrage angeben, muss eine dieser verfügbaren Versionen sein.

  3. Fordern Sie das Clusterupgrade an, indem Sie eine UserClusterUpgradeRequest-Ressource erstellen:

      kubectl --kubeconfig MANAGEMENT_API_SERVER apply -f - <<EOF
  apiVersion: cluster.gdc.goog/v1
  kind: UserClusterUpgradeRequest
  metadata:
    name: CLUSTER_NAME
    namespace: CLUSTER_NAMESPACE
  spec:
    clusterRef:
      name: CLUSTER_NAME
    targetVersion: TARGET_VERSION
  EOF

    Ersetzen Sie Folgendes:

    • MANAGEMENT_API_SERVER: der Pfad zur kubeconfig-Datei des Verwaltungs-API-Servers.
    • CLUSTER_NAME: der Name des Kubernetes-Clusters, der aktualisiert werden soll, z. B. user-vm-2.
    • CLUSTER_NAMESPACE: der Namespace des Kubernetes-Clusters. Verwenden Sie für freigegebene Cluster den Namespace platform. Verwenden Sie für Standardcluster den Projekt-Namespace des Clusters.
    • TARGET_VERSION: die Zielversion für das Upgrade, die im vorherigen Schritt identifiziert wurde, z. B. 1.30.1000-gke.85.

    Die durchschnittliche Upgradezeit für einen Kubernetes-Cluster beträgt etwa 20 Minuten.

  4. Prüfen Sie das Clusterupgrade, indem Sie die Ressource UserClusterUpgradeRequest überwachen:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
    describe userclusterupgraderequest CLUSTER_NAME \
    -n CLUSTER_NAMESPACE

    Ersetzen Sie Folgendes:

    • MANAGEMENT_API_SERVER: der Pfad zur kubeconfig-Datei des Verwaltungs-API-Servers.
    • CLUSTER_NAME: der Name des Kubernetes-Clusters, der aktualisiert werden soll, z. B. user-vm-2.
    • CLUSTER_NAMESPACE: der Namespace des Kubernetes-Clusters. Verwenden Sie für freigegebene Cluster den Namespace platform. Verwenden Sie für Standardcluster den Projekt-Namespace des Clusters.

    Sehen Sie sich den Abschnitt Spec der Ausgabe an. Sie enthält Current Version und Target Version. Das Upgrade wird noch ausgeführt, wenn sich Current Version und Target Version unterscheiden.

    Spec:
  ...
  Current Version: 1.29.500-gke.60
  Target Version: 1.30.1000-gke.85
Status:
  Conditions:
  - Message: Upgrade is in progress
    Reason: UpgradeInProgress
    Status: "False"
    Type: Succeeded

    Das Upgrade ist abgeschlossen und erfolgreich, wenn die Bedingung Succeeded den Status True hat und Current Version mit Target Version übereinstimmt.

    Wenn die Bedingung Succeeded den Status False hat, ist das Upgrade fehlgeschlagen. Wenn Fehler im Zusammenhang mit dem Upgrade Ihres Kubernetes-Clusters auftreten, wenden Sie sich an die Gruppe der Infrastrukturbetreiber, um weitere Unterstützung zu erhalten.

Clusterstatus nach dem Upgrade prüfen

Prüfen Sie nach dem Upgrade des Kubernetes-Clusters, ob der Cluster und seine Komponenten fehlerfrei sind. Prüfen Sie dazu den Ressourcenstatus von Cluster:

  1. Sehen Sie sich die Felder status.conditions und status.componentsConditions der Ressource Cluster an:

    kubectl --kubeconfig MANAGEMENT_API_SERVER \
    get cluster CLUSTER_NAME \
    -n CLUSTER_NAMESPACE -o yaml

    Ersetzen Sie Folgendes:

    • MANAGEMENT_API_SERVER: der Pfad zur kubeconfig-Datei des Verwaltungs-API-Servers.
    • CLUSTER_NAME: der Name des Kubernetes-Clusters, z. B. user-vm-2.
    • CLUSTER_NAMESPACE: der Namespace des Kubernetes-Clusters. Verwenden Sie für freigegebene Cluster den Namespace platform. Verwenden Sie für Standardcluster den Projekt-Namespace des Clusters.

  2. Prüfen Sie in der Ausgabe im Abschnitt status Folgendes:

    • Prüfen Sie in status.conditions, ob die Bedingung Ready den status True und die Bedingung Reconciling den status False hat.
    • Prüfen Sie in status.componentsConditions, ob die Bedingung Ready den status True hat, die Bedingung Reconciling den status False hat und keine Bedingung den reason ReconciliationError oder Reconciling hat.

    Bei Kubernetes-Clustern mit drei Knoten der Steuerungsebene und drei Worker-Knoten dauert das Upgrade etwa 20 Minuten. Wenn der Cluster oder seine Komponenten nach 20 Minuten im Status Reconciling verbleiben oder wenn eine Bedingung ReconciliationError anzeigt, wenden Sie sich an Ihre Infrastrukturbetreibergruppe, um weitere Unterstützung zu erhalten.

Nächste Schritte