Esegui l'upgrade di Kf su Google Cloud

Questo documento descrive come eseguire l'upgrade di un'installazione Kf esistente e delle relative dipendenze.

Nell'ambito della procedura di upgrade, assicurati che l'installazione di Kf utilizzi l'ultima versione dell'operatore Kf:

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

Prima di iniziare

Ti serviranno:

  • Un cluster esistente con Kf installato.
  • Accesso a una macchina con gcloud, kf e kubectl installati.

Prepararsi all'upgrade

Connettiti al cluster di destinazione

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

Verifica che le versioni attuali di Kf CLI e del server corrispondano

Esegui kf debug e verifica che le versioni dell'interfaccia a riga di comando Kf e del server Kf corrispondano.

  • La versione della CLI è elencata in Kf Client.
  • La versione del server Kf è elencata in kf["app.kubernetes.io/version"].
$ kf debug
...
Version:
  Kf Client:                        v2.7.3
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.7.3
...

Se i valori del client Kf e del server Kf non corrispondono, ma la versione del server è v2.7.x, installa la CLI Kf v2.9.0 prima di continuare.

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

Prima di eseguire l'upgrade, verifica che Kf sia integro

Esegui kf doctor per controllare lo stato del cluster. Prima di continuare, assicurati che tutti i test vengano superati.

$ 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 il comando finché non viene eseguito correttamente.

Eseguire l'upgrade dell'operatore

L'operatore Kf esegue gli upgrade per te.

  1. Applica il file yaml dell'operatore:

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

Esegui l'upgrade delle dipendenze di Kf

  1. Esegui l'upgrade di Tekton:

    kubectl apply -f "https://storage.googleapis.com/tekton-releases/pipeline/previous/v0.32.1/release.yaml"

  2. Esegui l'upgrade a Cloud Service Mesh v1.12:

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

  1. Esegui l'upgrade/l'installazione di Config Connector:

    Per l'upgrade da Kf v2.8: Segui i passaggi della sezione "Installare Config Connector" in Installazione di Kf.

    Per l'upgrade da Kf v2.7:

    1. Scarica il file tar dell'operatore Config Connector richiesto.

    2. Estrai il file tar.

      tar zxvf release-bundle.tar.gz

    3. Installa l'operatore Config Connector sul cluster.

      kubectl apply -f operator-system/configconnector-operator.yaml

Esegui l'upgrade all'interfaccia a riga di comando Kf v2.9.0

  1. Installa l'interfaccia a riga di comando:

    Linux

    Questo comando installa la CLI 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.9.0/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.9.0/kf-darwin /tmp/kf
chmod a+x /tmp/kf
sudo mv /tmp/kf /usr/local/bin/kf

    Cloud Shell

    Questo comando installa kf sull'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.9.0/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc

    Windows

    Viene scaricato kf nella directory corrente. Aggiungilo al percorso se vuoi chiamarlo da una posizione diversa dalla directory corrente.

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

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

    • La versione della CLI è elencata in Kf Client.
    • La versione del server Kf è elencata in kf["app.kubernetes.io/version"].
    $ kf debug
...
Version:
  Kf Client:                        v2.9.0
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.9.0
...

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

  1. Esegui doctor per assicurarti che la versione appena installata sia integra:

    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 e viene visualizzato il messaggio Error: environment failed checks, segui le indicazioni nell'output di doctor per risolvere il problema e riprova a eseguire il comando finché non va a buon fine.

Se i passaggi di verifica vanno a buon fine, l'upgrade del cluster è stato eseguito correttamente. In caso di problemi, consulta la pagina di assistenza per ricevere indicazioni.