Esegui l'upgrade di Anthos in esecuzione in modalità disconnessa

In questa pagina viene spiegato come eseguire l'upgrade di Anthos in esecuzione in modalità disconnessa.

Upgrade del cluster di amministrazione e Anthos Management Center

Gli operatori di infrastruttura possono eseguire l'upgrade del cluster di amministrazione e del Centro di gestione e dei relativi componenti.

Supporto della versione

  • Anthos in esecuzione in modalità disconnessa ora segue un criterio di ritiro per le versioni Anthos Anthos Config Management e Anthos Service Mesh. Ogni versione è classificata in uno dei quattro stati:

    • Supportato: questa versione è riconosciuta da Anthos in modalità disconnessa e può essere installata. Funziona con l'attuale Anthos in esecuzione nella versione del cluster in modalità disconnessa. Le versioni supportate saranno probabilmente deprecate nella prossima release secondaria di Anthos in esecuzione in modalità disconnessa.
    • Deprecata: questa versione è riconosciuta da Anthos in esecuzione in modalità disconnessa e può essere installata. Funziona con l'attuale Anthos in esecuzione nella versione del cluster in modalità disconnessa. Le versioni deprecate non saranno più supportate nella prossima versione secondaria di Anthos in esecuzione in modalità disconnessa.
    • Non supportato: questa versione è ancora riconosciuta da Anthos in esecuzione in modalità disconnessa, ma non può più essere installata. Potrebbe non funzionare nell'attuale Anthos in esecuzione in una versione del cluster in modalità disconnessa. Puoi comunque rimuovere una versione non supportata o eseguirne l'upgrade a una versione più recente. Le versioni non supportate verranno rimosse nel prossimo Anthos secondario in esecuzione in modalità disconnessa.
    • Rimosso: questa versione non è riconosciuta da Anthos in esecuzione in modalità disconnessa. Non può essere eseguito l'upgrade a una versione più recente e non può essere disinstallato automaticamente.

    Il ciclo di vita di ogni versione di Anthos Config Management e Anthos Service Mesh segue il modello di passaggio da Supportato a Ritirato in Non supportato a Rimosso.

    La tabella seguente mostra le norme sul ritiro delle versioni Anthos Anthos Config Management e Anthos Service Mesh.

    Anthos in esecuzione in modalità disconnessa 1.11 Supportato Deprecato Non supportato Rimosso
    Anthos Config Management 1,11,1 N/A 1,8.*, 1,9 1,7
    Anthos Service Mesh 1.11.8-asm.1 1,10.* 1,9 N/A

Prepara l'ambiente

  1. Esegui i comandi seguenti per scaricare la nuova release e impostare le autorizzazioni di esecuzione:

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

    Sostituisci UPGRADE_VERSION con la nuova versione a cui eseguire l'upgrade.

  2. Carica le nuove immagini nel registro privato con il comando seguente. Assicurati di utilizzare actl dalla versione UPGRADE_VERSION.

    actl images push --private-registry=${PRIVATE_REGISTRY} \
      --images ~/anthos-baremetal-private-mode
    

    Il processo di caricamento ignora automaticamente le immagini già presenti nel Registro di sistema.

  3. Caricare i grafici Helm in Container Registry.

Esegui l'upgrade del cluster di amministrazione

Per eseguire l'upgrade del cluster di amministrazione, aggiorna il file di configurazione del cluster di amministrazione solo con le seguenti modifiche, quindi esegui il comando actl clusters baremetal upgrade per completare l'upgrade.

  1. Nel file YAML amministratore di configurazione del cluster, aggiorna la stringa di versione e aggiungi l'annotazione baremetal.cluster.gke.io/private-mode: "true".

    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: admin
      namespace: cluster-admin
      annotations:
        baremetal.cluster.gke.io/private-mode: "true"
    spec:
      anthosBareMetalVersion: VERSION
    

    Sostituisci VERSION con il nuovo numero di versione di Anthos su Bare Metal.

  2. Esegui il comando seguente per aggiornare il cluster di amministrazione. Assicurati di utilizzare actl dalla versione UPGRADE_VERSION.

    actl clusters baremetal upgrade admin --kubeconfig=ADMIN_KUBECONFIG
    

L'upgrade potrebbe richiedere dai 15 ai 20 minuti, ma potrebbe richiedere più tempo a seconda delle dimensioni del cluster.

Centro di gestione dell'upgrade

Gli operatori dell'infrastruttura possono eseguire l'upgrade completo del Centro di gestione o eseguendo l'upgrade dei singoli componenti secondari.

Opzione 1: esegui l'upgrade dell'intero Centro di gestione

Gli operatori di infrastruttura possono eseguire l'upgrade di tutti i componenti nel Centro di gestione, incluso il Centro di gestione stesso.

  1. Verifica la versione del Centro di gestione per verificare che sia una versione precedente:

    kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
    

    Sostituisci ADMIN_KUBECONFIG con il percorso del file kubeconfig per il cluster di amministrazione.

  2. (Facoltativo) Esegui il controllo preliminare per l'upgrade:

    actl platform management-center upgrade --preflight-check-only --kubeconfig=ADMIN_KUBECONFIG
    
  3. Avvia l'upgrade (in genere richiede 10-15 minuti per essere completato):

    actl platform management-center upgrade --kubeconfig=ADMIN_KUBECONFIG
    
  4. Controlla la versione del Centro di gestione per verificare che sia aggiornata:

    kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
    

Opzione 2: eseguire l'upgrade dei singoli componenti

Gli operatori di infrastruttura possono gestire gli upgrade di un componente specifico che viene eseguito nel Centro di gestione. A partire dalla versione 1.9, sono disponibili l'upgrade individuale di tre componenti: l'operatore Anthos Config Management, l'operatore Anthos Service Mesh e Anthos su Bare Metal.

Dopo aver caricato le immagini in Container Registry, devi pubblicare le specifiche del pacchetto fornite nella nuova release. Ad esempio, le specifiche del pacchetto per l'operatore Anthos Config Management e Anthos Service Mesh sono disponibili in services/.

  1. Applica la specifica del pacchetto per il nuovo operatore Anthos Config Management.

    kubectl apply -f ~/anthos-baremetal-private-mode/services/anthos-config-management/package-spec.yaml \
    --kubeconfig=ADMIN_KUBECONFIG
    
  2. Controlla lo stato corrente del componente dell'operatore Anthos Config Management.

    kubectl get adminoperator admin-operator \
      --kubeconfig=ADMIN_KUBECONFIG \
      -ojsonpath='{.status.components[?(@.name=="anthos-config-management")]}'
    

    Supponiamo che il comando dia la versione corrente di 1.9.X e il vincolo di versione corrente di <=1.9.X.

    {"name":"anthos-config-management","version":"1.9.X","versionConstraint":"<=1.9.X"}
    
  3. Abilita la nuova versione modificando i vincoli della versione nell'oggetto amministratore amministratore.

    kubectl edit AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
    
  4. Nell'editor, individua i criteri di aggiornamento in spec.updateConfigOverride.policies e aumenta di conseguenza le versioni dei componenti. Se spec.updateConfigOverride viene omesso o ha un valore struttura non specificato ({}), aggiungi il criterio come segue.

    spec:
      updateConfigOverride:
        policies:
        - name: anthos-config-management
          versionConstraint: <=1.9.Y
    

Dopo aver aggiunto l'override, il Centro di gestione del deployment implementa la modifica per scegliere la versione più recente dell'operatore Anthos Config Management.

Esegui il comando seguente per monitorare l'implementazione della nuova versione, che dovrebbe essere modificata dalla versione precedente di 1.9.X a 1.9.Y.

kubectl get adminoperator admin-operator \
  --kubeconfig=ADMIN_KUBECONFIG \
  -ojsonpath='{.status.components[?(@.name=="anthos-config-management")].version}' \
  --watch

Una volta completata l'implementazione, gli amministratori della piattaforma potranno utilizzare il nuovo operatore Anthos Config Management attraverso il Centro di gestione.

Esegui l'upgrade dei cluster utente

Gli amministratori delle piattaforme possono aggiornare i cluster utente utilizzando lo strumento a riga di comando actl, il Centro di gestione o tramite l'API.

Actl

Esegui il comando seguente per aggiornare un cluster utente:

actl clusters baremetal upgrade CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

console

  1. Nella Console di gestione, vai al menu Dashboard.
  2. Fai clic sulla scheda Upgrades (Upgrade) per visualizzare tutti gli upgrade disponibili.
  3. Fai clic su Visualizza upgrade per il cluster di cui vuoi eseguire l'upgrade.
  4. Fai clic su Upgrade per visualizzare i dettagli dell'upgrade, ad esempio versione, descrizione e un link alle note di rilascio.
  5. Fai clic su Continua per confermare.
  6. Fai clic su Esegui l'upgrade per avviare l'upgrade del cluster.

La voce nell'elenco upgrade mostra Upgrade in progress fino al termine dell'upgrade.

API

Puoi eseguire l'upgrade di un cluster utente modificando la stringa di versione nella risorsa Cluster.

  1. Esegui il comando seguente per modificare la risorsa Cluster per un cluster utente.

    kubectl edit cluster CLUSTER_NAME -n cluster-CLUSTER_NAME --kubeconfig=ADMIN_KUBECONFIG
    
  2. Aggiorna la stringa della versione in spec.anthosBareMetalVersion per far sì che i controller funzionino sugli upgrade.

    apiVersion: baremetal.cluster.gke.io/v1
    kind: Cluster
    metadata:
      name: CLUSTER_NAME
      namespace: cluster-CLUSTER_NAME
      annotations:
        baremetal.cluster.gke.io/private-mode: "true"
    spec:
      type: user
      anthosBareMetalVersion: VERSION
    

    Sostituisci VERSION con il nuovo numero di versione di Anthos su Bare Metal.

Passaggi successivi