Upgrade di Kf

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

Prima di iniziare

Avrai bisogno di:

Un cluster esistente con Kf installato.
Accesso a un computer su cui sono installati gcloud, kf e kubectl.

Convalida l'installazione esistente di Knowledge Fusion

Recupera le credenziali di autenticazione per interagire con il cluster:

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

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.0.0
  Server version:                   v1.17.13-gke.1401
  kf["app.kubernetes.io/version"]:  v2.0.0
...
```
Se il client Kf e il server Kf i valori non corrispondono, scarica e installa la versione dell'interfaccia a riga di comando Kf che corrisponda alla versione del server, quindi ripeti il controllo con la nuova interfaccia a riga di comando. Prima di continuare, la versione del client CLI deve corrispondere alla versione del server.
Esegui kf doctor per controllare lo stato del cluster. Assicurati che tutti i test siano stati superati prima di continuare.
```
$ kf doctor
...
=== RUN doctor/user
=== RUN doctor/user/ContainerRegistry
--- PASS: doctor/user
   --- PASS: doctor/user/ContainerRegistry
...
```
Se vedi il messaggio Error: environment failed checks, segui le indicazioni nell'output doctor per risolvere il problema e riprova a eseguire il comando fino a quando non viene eseguito correttamente.

Esegui l'upgrade

Per eseguire l'upgrade di Kf, svolgi i seguenti passaggi:

Prepara l'ambiente locale e l'upgrade.
Esegui l'upgrade delle dipendenze di Kf.
Esegui l'upgrade di Kf e verifica che l'upgrade sia stato eseguito correttamente.

Preparare l'upgrade

Esegui kf version per ottenere la versione corrente di Kf.
```
$ kf version
kf version v2.0.0 linux
```
Trova la versione successiva di Kf dalla pagina dei download.

Avviso: al momento Kf supporta solo l'upgrade di uno una versione secondaria alla volta. Ad esempio, da v2.0.0 a v2.1.0.
1. Scarica il file YAML della release Kf e salvalo come kf-release.yaml.
2. Scarica la versione di Kf per il tuo sistema operativo e il tuo nome kf-next.
3. Esegui chmod per rendere eseguibile kf-next:
```
chmod +x kf-next
```
4. Esegui kf-next version per assicurarti che la versione scaricata corrisponda alla versione di Kf che vuoi installare:
```
$ kf-next version
kf version v2.1.0 linux
```
Esegui un backup della configmap config-defaults eseguendo:
```
kubectl get configmap config-defaults -o yaml -n kf > config-defaults-backup.yaml
```
Nota: questo backup è solo di riferimento e non deve essere applicato direttamente.
Esegui kubectl diff -f kf-release.yaml e controlla le modifiche apportate dall'upgrade al cluster.

Nota: presta attenzione alla configmap di config-defaults. Kf utilizza questa configmap per archiviare le personalizzazioni a livello di cluster, come domini, flag di funzionalità e registry dei container.
Modifica kf-release.yaml e modificalo per conservare tutte le modifiche che vuoi mantenere.

Ad esempio, se imposti la proprietà configmap config-defaultsspaceDefaultToV3Stack su false in v2.0.0 di Kf, la release v2.1.0 avrà il valore predefinito true.
Esegui di nuovo kubectl diff -f kf-release.yaml per verificare che le modifiche siano state apportate per produrre l'output previsto.

Esegui l'upgrade delle dipendenze Kf

Apri la pagina dei download e individua la matrice delle dipendenze per la versione di Knowledge Fusion a cui esegui l'upgrade.
Esegui l'upgrade di Tekton:
1. Apri la pagina Release di Tekton.
2. Trova la versione di Tekton elencata nella matrice di dipendenza di Kf.
3. Esegui il comando riportato nella sezione "Comando di installazione in una riga" per eseguire l'upgrade di Tekton.
Esegui l'upgrade di Cloud Service Mesh:
1. Apri la guida all'upgrade di Cloud Service Mesh.
2. Nell'elenco a discesa delle versioni, scegli la versione di Cloud Service Mesh elencata nella tabella di dipendenza di Kf.
3. Segui la guida per eseguire l'upgrade di ASM.

Esegui l'upgrade e verifica Kf

Installa i componenti Kf aggiornati utilizzando configurazione della release:
```
kubectl apply -f kf-release.yaml
```
Esegui doctor per assicurarti che la versione appena installata sia in buono stato:
```
kf-next doctor --retries=12 --delay=5s
```
Il comando eseguirà più volte i controlli del cluster. È normale che alcuni di questi il tentativo non andrà a buon fine durante l'avvio dei nuovi controller.

Se il comando ha esito negativo con il messaggio Error: environment failed checks, segui le indicazioni nell'output doctor per risolvere il problema e riprova a eseguire l'operazione fino a quando non riesce.
Sostituisci l'interfaccia a riga di comando kf esistente sul tuo sistema con l'interfaccia a riga di comando kf-next.
```
chmod +x kf-next
mv kf-next $(which kf)
```
Nota: potresti dover eseguire questo comando come super utente utilizzando sudo se Kf è installato a livello globale.

Confronta il file config-defaults-backup.yaml con kubectl diff -f config-defaults-backup.yaml per assicurarti che il cluster sia ancora configurato correttamente.

Ad esempio, se hai mantenuto tutte le modifiche della vecchia versione di Kf e hai approvato l'utilizzo di un nuovo buildpack in bundle con la versione successiva di Kf:

$ kubectl diff -f config-defaults-backup.yaml
diff -u -N /tmp/LIVE/v1.ConfigMap.kf.config-defaults /tmp/MERGED/v1.ConfigMap.kf.config-defaults
--- /tmp/LIVE/v1.ConfigMap.kf.config-defaults
+++ /tmp/MERGED/v1.ConfigMap.kf.config-defaults
@@ -131,6 +131,8 @@
     enable_route_services: false
   spaceBuildpacksV2: |
-    - name: new_buildpack
-      url: https://github.com/cloudfoundry/new-buildpack
     - name: staticfile_buildpack
       url: https://github.com/cloudfoundry/staticfile-buildpack
     - name: java_buildpack
exit status 1