Upgrade di Cluster Anthos su Bare Metal

Upgrade di Cluster Anthos su Bare Metal

Quando installi una nuova versione di bmctl, puoi eseguire l'upgrade dei cluster esistenti creati con una versione precedente. L'upgrade di un cluster alla versione più recente di Cluster Anthos su Bare Metal offre ulteriori funzionalità e correzioni al cluster. Inoltre, garantisce che il cluster rimanga supportato. Puoi eseguire l'upgrade dei cluster di amministrazione, ibrido, autonomo o utente con il comando bmctl upgrade cluster.

I controlli preliminari vengono eseguiti prima di un upgrade del cluster per convalidare lo stato del cluster e l'integrità del nodo.

Gli esempi seguenti mostrano il processo di upgrade dalla versione iniziale 1.6.0 ai cluster Anthos su Bare Metal 1.6.1.

Puoi eseguire l'upgrade da 1.6.1 a 1.6.2 nello stesso modo. Sono supportati anche gli upgrade da 1.6.0 a 1.6.2.

Upgrade di cluster Anthos, amministratore o cluster autonomi su Bare Metal

Quando scarichi e installi una nuova versione di bmctl, puoi eseguire l'upgrade dei cluster amministrativi, ibridi e autonomi creati con una versione precedente. Per una determinata versione di bmctl, è possibile eseguire l'upgrade dei cluster solo alla stessa versione.

Innanzitutto, scarica l'ultima versione di bmctl, quindi modifica i file di configurazione del cluster appropriati, quindi esegui il comando bmctl upgrade cluster per completare l'upgrade.

  1. Scarica la versione più recente di bmctl dal bucket Cloud Storage:
    gsutil cp gs://anthos-baremetal-release/bmctl/1.6.2/linux-amd64/bmctl bmctl
    chmod a+x bmctl
    
  2. Modifica il file YAML di configurazione del cluster per cambiare la versione del cluster Anthos su Bare Metal da 1.6.1 a 1.6.2. Di seguito è riportato un esempio di configurazione di un cluster di amministrazione:
  3. ---
    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: cluster1
      namespace: cluster-cluster1
    spec:
      # Cluster type. This can be:
      #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
      #   2) user:   to create a user cluster. Requires an existing admin cluster.
      #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
      #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
      type: admin
      # Anthos cluster version.
      # Change the following line from 1.6.0 to 1.6.1, shown below
      anthosBareMetalVersion: 1.6.1
    
  4. Utilizza il comando bmctl upgrade cluster per completare l'upgrade, dove CLUSTER_NAME è il nome del tuo cluster. ADMIN_KUBECONFIG specifica il percorso del file kubeconfig del cluster di amministrazione:
  5. bmctl upgrade cluster -c CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG
    

Upgrade di un cluster utente

Dopo aver eseguito correttamente l'upgrade di un cluster di amministrazione, ibrido o autonomo, puoi eseguire l'upgrade del cluster utente che gestisce.

Prima di tutto, modifica il file di configurazione del cluster utente appropriato, quindi esegui il comando kubectl apply per applicare il file di configurazione rivisto e completare l'upgrade.

  1. Modifica il file YAML di configurazione del cluster utente per cambiare la versione del cluster Anthos su Bare Metal da 1.6.0 a 1.6.1
  2. ---
    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: cluster1
      namespace: cluster-cluster1
    spec:
      # Cluster type. This can be:
      #   1) admin:  to create an admin cluster. This can later be used to create user clusters.
      #   2) user:   to create a user cluster. Requires an existing admin cluster.
      #   3) hybrid: to create a hybrid cluster that runs admin cluster components and user workloads.
      #   4) standalone: to create a cluster that manages itself, runs user workloads, but does not manage other clusters.
      type: user
      # Anthos cluster version.
      # Change the following line from 1.6.0 to 1.6.1, shown below
      anthosBareMetalVersion: 1.6.1
    
  3. Esegui il comando kubectl per applicare la configurazione del cluster utente rivista e creare il cluster:
  4.   kubectl --kubeconfig ADMIN_KUBECONFIG apply -f USER_CLUSTER_CONFIG
      
    ADMIN_KUBECONFIG specifica il percorso del file kubeconfig del cluster di amministrazione, mentre USER_CLUSTER_CONFIG specifica il percorso del file YAML del cluster utente che hai modificato nella sezione precedente. Ad esempio, per un cluster di amministrazione denominato admin e una configurazione del cluster utente denominata user1, il comando sarebbe:
    kubectl --kubeconfig bmctl-workspace/admin/admin-kubeconfig apply /
      -f bmctl-workspace/user1/user1.yaml
    

Verifica dell'upgrade del cluster utente

Per verificare la versione del cluster utente dopo un upgrade, utilizza il comando kubectl get per restituire la versione.

Ad esempio, per verificare che la versione del cluster sia alla 1.6.1 dopo l'upgrade dalla 1.6.0, esegui il comando seguente:

kubectl get cluster.baremetal.cluster.gke.io -n cluster-USER_CLUSTER_NAME \
  -o jsonpath='{.status.anthosBareMetalVersion}' --kubeconfig ADMIN_KUBECONFIG

Dove:

  • ADMIN_KUBECONFIG specifica il percorso del file kubeconfig del cluster di amministrazione.
  • USER_CLUSTER_NAME è il nome del cluster utente.

Se l'upgrade è riuscito, il comando restituisce il numero di versione aggiornato. Tieni presente che l'upgrade può richiedere fino a 30 minuti.