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

Questa pagina spiega come eseguire l'upgrade di Anthos in esecuzione in modalità disconnessa.

Upgrade del cluster di amministrazione e di Anthos Management Center

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

Supporto della versione

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

    • Supportato: questa versione è riconosciuta da Anthos in esecuzione in modalità disconnessa e può essere installata. Funziona nell'attuale Anthos in esecuzione in versione cluster disconnesso. Le versioni supportate saranno probabilmente deprecate nel prossimo Anthos secondario in esecuzione in modalità disconnessa.
    • Deprecata: questa versione è riconosciuta da Anthos in esecuzione in modalità disconnessa e può essere installata. Funziona nell'attuale Anthos in esecuzione in versione cluster disconnesso. Le versioni deprecate non saranno supportate nel successivo Anthos secondario in esecuzione in modalità disconnessa.
    • Non supportata: questa versione è ancora riconosciuta da Anthos in esecuzione in modalità disconnessa, ma non può più essere installata. Potrebbe non funzionare nella versione attuale di Anthos in esecuzione in versione cluster in modalità disconnessa. È ancora possibile 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.
    • Rimossa: questa versione non è riconosciuta dall'installazione di Anthos in modalità disconnessa. Non può essere eseguito l'upgrade a una versione più recente e non può essere disinstallata automaticamente.

    Il ciclo di vita di ogni versione di Anthos Config Management e Anthos Service Mesh segue lo schema del passaggio da Supportato a Ritirato a Non supportato in Rimuovi.

    La tabella seguente mostra i criteri di ritiro delle versioni Anthos Anthos Config Management e Anthos Service Mesh.

    Anthos in esecuzione in modalità disconnessa 1.12 Supportato Deprecato Non supportato Rimosso
    Anthos Config Management 1,12,0 1,11,1 1,10.* 1.8.*,1.9.*
    Anthos Service Mesh 1.12.7-asm.2 1,11*. 1,10.* 1,9*

Prepara l'ambiente

  1. Esegui questi comandi 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 di cui vuoi 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à esistenti nel Registro di sistema.

  3. Carica 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 con le modifiche indicate di seguito, quindi esegui il comando actl clusters baremetal upgrade per completare l'upgrade.

  1. Nel file YAML amministratore della 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 questo comando 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 circa 15-20 minuti, ma potrebbe richiedere più tempo, a seconda delle dimensioni del cluster.

Centro gestione upgrade

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

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

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

  1. Controlla la versione del Centro di gestione per verificare che si tratti di 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 circa):

    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 dell'infrastruttura possono gestire gli upgrade di un componente specifico eseguito nel Centro gestione. A partire dalla versione 1.9, tre componenti sono aggiornabili singolarmente: 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 l'operatore 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 attuale dei componenti dell'operatore Anthos Config Management.

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

    Supponiamo che il comando fornisca 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. Abilitare la nuova versione modificando i vincoli di versione nell'oggetto Console di amministrazione.

    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 struct vuoto ({}), aggiungi il criterio come indicato di seguito.

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

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

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

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

Al termine del lancio, gli amministratori della piattaforma potranno utilizzare il nuovo operatore Anthos Config Management tramite il Centro gestione.

Upgrade di 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 questo comando 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 vedere tutti gli upgrade disponibili.
  3. Fai clic su Visualizza upgrade per il cluster di cui vuoi eseguire l'upgrade.
  4. Fai clic su Esegui l'upgrade per visualizzare i dettagli dell'upgrade, ad esempio la versione, la descrizione e un link alle note di rilascio.
  5. Fai clic su Continua per confermare.
  6. Fai clic su Esegui upgrade per avviare l'upgrade del cluster.

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

Server

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

  1. Esegui questo comando 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 di versione in spec.anthosBareMetalVersion per consentire ai controller di eseguire gli 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