Mettre à niveau Kf en dehors de Google Cloud

Ce document explique comment mettre à niveau une installation Kf existante et ses dépendances.

Au cours de la procédure de mise à niveau, vous devez vous assurer que votre installation de Kf utilise la dernière version de l'opérateur Kf :

Vérifiez que votre version de Kf actuelle peut être mise à niveau vers la version Kf v2.6.1.
Passez à Kf v2.6.1.
Mettez à niveau les dépendances (si nécessaire).

Avant de commencer

Vous avez alors besoin de :

Un cluster existant sur lequel Kf est installé.
Un accès à une machine sur laquelle gcloud, kf et kubectl sont installés.

Anticiper la mise à niveau

Se connecter à votre cluster cible

gcloud container hub memberships get-credentials CLUSTER_NAME \
 --zone CLUSTER_ZONE \
 --project CLUSTER_PROJECT_ID

Vérifier que les versions de CLI Kf et de serveur actuelles se correspondent

Exécutez kf debug et validez la correspondance entre les versions CLI et serveur de Kf.

La version de la CLI apparaît sous Kf Client.
La version du serveur Kf apparaît sous 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
...

Si les valeurs du client Kf et du serveur Kf ne correspondent pas, mais que la version du serveur est v2.5.x, installez la CLI Kf v2.6.1 avant de continuer.

Si la version du serveur Kf est antérieure à la version 2.5.x, vous devez d'abord effectuer une mise à niveau vers Kf v2.5.x afin de continuer.

Vérifier que Kf est opérationnel avant de procéder à la mise à niveau

Exécutez kf doctor pour vérifier l'état de votre cluster. Avant de continuer, assurez-vous que tous les tests sont concluants.

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

Si vous voyez les messages FAIL ou Error: environment failed checks, suivez les instructions dans la sortie kf doctor ou consultez le guide de dépannage pour résoudre le problème et réessayez la commande jusqu'à ce qu'elle aboutisse.

Mettre à niveau l'opérateur

L'opérateur Kf effectue des mises à niveau pour vous.

Appliquez l'opérateur YAML :

Remarque : Cette opération démarre immédiatement et elle est irréversible.
```
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.6.1/operator.yaml"
```

Mettre à niveau les dépendances Kf

Mettez à niveau Tekton :

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

Effectuez la mise à niveau vers la dernière version de Cloud Service Mesh :
1. Suivez les étapes du guide de mise à niveau de Cloud Service Mesh.

Mettre à niveau la CLI Kf vers la version 2.6.1

Installez la CLI :
Linux
Cette commande installe la CLI Kf pour tous les utilisateurs du système. Suivez les instructions de l'onglet Cloud Shell pour l'installer juste pour vous.
```
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
Cette commande installe kf pour tous les utilisateurs du système.
```
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
kf sera installé sur votre instance Cloud Shell si vous utilisez bash, et vous devrez peut-être modifier les instructions pour les autres interfaces système.
```
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
kf sera téléchargé dans le répertoire actuel. Si vous souhaitez l'appeler depuis un emplacement autre que le répertoire actuel, ajoutez-le au chemin d'accès.
```
gcloud storage cp gs://kf-releases/v2.6.1/kf-windows.exe kf.exe
```
Validez la correspondance des versions de la CLI Kf et du serveur Kf :
- La version de la CLI apparaît sous Kf Client.
- La version du serveur Kf apparaît sous 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
...
```

Vérifier que Kf a bien été mis à niveau

Exécutez doctor pour vous assurer que la version qui vient d'être installée est opérationnelle :
```
kf doctor --retries=20
```
La commande exécute à plusieurs reprises les vérifications de cluster. Il est normal que certaines tentatives échouent lors du démarrage des nouveaux contrôleurs.

Si la commande échoue avec le message Error: environment failed checks, suivez les instructions fournies dans le résultat doctor pour résoudre le problème et relancez la commande jusqu'à ce qu'elle aboutisse.

Si les étapes de validation réussissent, votre cluster a bien été mis à niveau. Si vous rencontrez des problèmes, veuillez consulter la page Assistance pour obtenir des conseils.