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.6.1.
  • Esegui l'upgrade a Kf v2.6.1.
  • 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.5.4
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.5.4
...

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

Se il valore del server Kf è precedente alla versione 2.5.x, devi prima eseguire l'upgrade incrementale a Kf 2.5.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.6.1/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.26.0/release.yaml"

  2. Esegui l'upgrade all'ultima versione di Cloud Service Mesh:

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

  1. Esegui l'upgrade di Config Connector.

    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.6.1

  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.6.1/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.6.1/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.6.1/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.6.1/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.6.1
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.6.1
...

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.