Esegui l'upgrade della modalità privata Anthos

Questa pagina spiega come eseguire l'upgrade della modalità privata Anthos.

Eseguire l'upgrade del cluster di amministrazione e di Anthos Management Center

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

Prepara l'ambiente

Esegui il comando seguente 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.8/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 vuoi eseguire l'upgrade.

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.

Upgrade del cluster di amministrazione

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

Nel file YAML amministratore della configurazione del cluster, aggiorna la stringa della versione.
```
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: admin
  namespace: cluster-admin
spec:
  anthosBareMetalVersion: VERSION
```
Sostituisci VERSION con il nuovo numero della versione Bare Metal di Anthos.
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 degli upgrade

Gli operatori infrastrutturali possono eseguire l'upgrade del Centro di gestione per intero o eseguendo l'upgrade dei singoli sottocomponenti.

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

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

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.

Facoltativo: esegui il controllo preflight per l'upgrade:

actl platform management-center upgrade --preflight-check-only --kubeconfig=ADMIN_KUBECONFIG

Avvia l'upgrade (in genere sono necessari circa 10-15 minuti):

actl platform management-center upgrade --kubeconfig=ADMIN_KUBECONFIG

Controlla la versione del Centro di gestione per verificare che sia aggiornata:
```
kubectl get AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```

Opzione 2: esegui l'upgrade dei singoli componenti

Gli operatori infrastrutturali possono gestire gli upgrade di un componente specifico eseguito nel Centro di gestione. A partire dalla versione 1.8, tre componenti sono aggiornabili singolarmente: l'operatore Anthos Config Management e l'operatore Anthos Service Mesh e Anthos su Bare Metal.

Dopo aver caricato le immagini nel Container Registry, devi pubblicare le specifiche del pacchetto spedite 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/.

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

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 fornisca la versione corrente di 1.8.X e l'attuale vincolo relativo alla versione di <=1.8.X.

{"name":"anthos-config-management","version":"1.8.X","versionConstraint":"<=1.8.X"}

Abilita la nuova versione modificando i vincoli di versione nell'oggetto Operatore.
```
kubectl edit AdminOperator admin-operator --kubeconfig=ADMIN_KUBECONFIG
```
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 di struttura vuoto ({}), aggiungi il criterio come segue.
```
spec:
  updateConfigOverride:
    policies:
    - name: anthos-config-management
      versionConstraint: <=1.8.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 da 1.8.X a 1.8.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 possono utilizzare il nuovo operatore Anthos Config Management attraverso il Centro di gestione.

Upgrade dei cluster utente

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

Actl

Esegui il comando seguente per aggiornare un cluster utente:

actl clusters baremetal upgrade CLUSTER_NAME --kubeconfig ADMIN_KUBECONFIG

Console

Nella console del Centro di gestione, vai al menu Dashboard.
Fai clic sulla scheda Upgrade per vedere tutti gli upgrade disponibili.
Fai clic su Visualizza upgrade per il cluster per cui vuoi eseguire l'upgrade.
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.
Fai clic su Continua per confermare.
Fai clic su Upgrade per eseguire l'upgrade del cluster.

La voce nell'elenco di 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.

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

Aggiorna la stringa di versione in spec.anthosBareMetalVersion: i controller funzioneranno sugli upgrade.

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

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