Upgrade di Kf

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

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

  • Verifica che la tua versione Kf corrente possa eseguire l'upgrade a Kf v2.5.4.
  • Aggiornamento a Kf v2.5.4.
  • 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.

Preparazione per l'upgrade

Connettiti al cluster di destinazione

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

Conferma che l'attuale interfaccia a riga di comando Kf e le versioni 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.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 è v2.4.x, installa l'interfaccia a riga di comando Kf v2.5.4 prima di continuare.

Se il valore del server Kf è precedente alla v2.4.x, per continuare è necessario prima eseguire l'upgrade incrementale a Kf v2.4.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.5.4/operator.yaml"

Esegui l'upgrade delle dipendenze Kf

  1. Esegui l'upgrade di Tekton:

  2. Esegui l'upgrade all'ultima versione 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 v2.5.4

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

    gsutil 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 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.5.4/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.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 è 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.20.6-gke.1000
      kf["app.kubernetes.io/version"]:  v2.5.4
    ...
    

Verifica dell'upgrade di Kf riuscito

  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.