Upgrade di Kf

Nell'ambito della procedura di upgrade, assicurati che l'installazione di Kf utilizzi la versione più recente dell'operatore Kf:

• Verifica che la tua versione attuale di Knowledge Fusion possa essere aggiornata alla versione 2.5.4.
• Esegui l'upgrade a Kf 2.5.4.
• Esegui l'upgrade delle dipendenze (se necessario).

Prima di iniziare

Avrai bisogno di:

• Un cluster esistente con Kf installato.
• Accedi a una macchina su cui sono installati gcloud, kf e kubectl.

Preparazione dell'upgrade

Connettiti al cluster di destinazione

gcloud container clusters get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

Verificare la corrispondenza delle versioni correnti della CLI di Kf e del server

Esegui kf debug e convalida la corrispondenza delle versioni dell'interfaccia a riga di comando Kf e del server Kf.

• La versione dell'interfaccia a riga di comando è indicata in Kf Client.
• La versione del server Kf è indicata in kf["app.kubernetes.io/version"].

$ kf debug
...
Version:
  Kf Client:                        v2.4.1
  Server version:                   v1.20.6-gke.1000
  kf["app.kubernetes.io/version"]:  v2.4.1
...

Se i valori del client Kf e del server Kf non corrispondono, ma la versione del server è 2.4.x, installa l'interfaccia a riga di comando Kf 2.5.4 prima di continuare.

Se il valore del server Kf è precedente alla versione 2.4.x, devi prima eseguire l'upgrade incrementale alla versione 2.4.x di Kf per continuare.

Verificare che Kf sia in buono stato prima dell'upgrade

Esegui kf doctor per controllare lo stato del cluster. Assicurati che tutti i test siano stati superati prima di continuare.

$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...

Se visualizzi messaggi FAIL o Error: environment failed checks, segui le indicazioni nell'output kf doctor o consulta la guida alla risoluzione dei problemi per risolvere il problema e riprova a eseguire il comando fino a quando non viene eseguito correttamente.

Eseguire l'upgrade dell'operatore

L'operatore Kf esegue gli upgrade per tuo conto.

1. Applica il file yaml dell'operatore:

   kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.5.4/operator.yaml"

Esegui l'upgrade delle dipendenze di Kf

1. Esegui l'upgrade di Tekton:

2. Esegui l'upgrade alla versione più recente di Cloud Service Mesh:

   1. Segui i passaggi descritti nella guida all'upgrade di Cloud Service Mesh.

3. Esegui l'upgrade di Config Connector.

Esegui l'upgrade all'interfaccia a riga di comando Kf 2.5.4

1. Installa l'interfaccia a riga di comando:

   Linux

   Questo comando installa la CLI di Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo solo per te.

   gcloud storage cp gs://kf-releases/v2.5.4/kf-linux /tmp/kf
   chmod a+x /tmp/kf
   sudo mv /tmp/kf /usr/local/bin/kf

   Mac

   Questo comando installa kf per tutti gli utenti del sistema.

   gcloud storage cp gs://kf-releases/v2.5.4/kf-darwin /tmp/kf
   chmod a+x /tmp/kf
   sudo mv /tmp/kf /usr/local/bin/kf

   Cloud Shell

   Questo comando installa kf nell'istanza Cloud Shell. Se utilizzi bash, le istruzioni potrebbero dover essere modificate per altre shell.

   mkdir -p ~/bin
   gcloud storage cp gs://kf-releases/v2.5.4/kf-linux ~/bin/kf
   chmod a+x ~/bin/kf
   echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
   source ~/.bashrc

   Windows

   Verrà scaricato kf nella directory corrente. Aggiungila al percorso se vuoi chiamarla da un punto diverso dalla directory corrente.

   gcloud storage cp gs://kf-releases/v2.5.4/kf-windows.exe kf.exe

2. Verifica che le versioni dell'interfaccia a riga di comando Kf e del server Kf corrispondano:

   • La versione dell'interfaccia a riga di comando è indicata in Kf Client.
   • La versione del server Kf è indicata in kf["app.kubernetes.io/version"].

   $ kf debug
   ...
   Version:
     Kf Client:                        v2.5.4
     Server version:                   v1.20.6-gke.1000
     kf["app.kubernetes.io/version"]:  v2.5.4
   ...
   

Verificare che l'upgrade di Kf sia andato a buon fine

1. Esegui doctor per assicurarti che la versione appena installata sia in buono stato:

   kf doctor --retries=20

   Il comando esegue i controlli del cluster più volte. È normale che alcuni tentativi non vadano a buon fine durante l'avvio dei nuovi controller.

   Se il comando non va a buon fine con il messaggio Error: environment failed checks, segui le indicazioni nell'output doctor per risolvere il problema e riprova a eseguire il comando finché non va a buon fine.

Se i passaggi di verifica vengono superati, l'upgrade del cluster è andato a buon fine. In caso di problemi, consulta la pagina di assistenza per indicazioni.