Esegui l'upgrade di Kf su Google Cloud

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

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

  • Verifica che sia possibile eseguire l'upgrade della tua versione Kf corrente a Kf v2.6.1.
  • Aggiornamento 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 un computer su cui sono installati gcloud, kf e kubectl.

Prepararsi per l'upgrade

Connettiti al cluster di destinazione

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

Conferma che le attuali versioni dell'interfaccia a riga di comando Kf e del server corrispondano

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 è elencata sotto Kf Client.
  • La versione del server Kf è indicata sotto 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 l'interfaccia a riga di comando Kf v2.6.1 prima di continuare.

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

Verifica che Kf sia integro prima di eseguire l'upgrade

Esegui kf doctor per verificare lo stato del cluster. Assicurati che tutti i test superino prima di continuare.

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

Se viene visualizzato un messaggio 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 riesce.

Esegui 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.6.1/operator.yaml"

Esegui l'upgrade delle dipendenze 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 l'interfaccia a riga di comando Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo autonomamente.

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

    gsutil 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 sulla tua istanza di Cloud Shell se utilizzi bash. Potrebbe essere necessario modificare le istruzioni per altre shell.

    mkdir -p ~/bin
gsutil 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

    Questa operazione scarica kf nella directory corrente. Aggiungila al percorso se vuoi effettuare una chiamata da qualsiasi posizione diversa dalla directory attuale.

    gsutil cp gs://kf-releases/v2.6.1/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 è elencata sotto Kf Client.
    • La versione del server Kf è indicata sotto 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 integro:

    kf doctor --retries=20

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

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

Se i passaggi di verifica vengono superati, l'upgrade del cluster è stato eseguito correttamente. In caso di problemi, consulta la pagina di assistenza per avere indicazioni.