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

Ottieni 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 è indicata in 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, segui questi passaggi:

Prepara l'ambiente locale e l'upgrade.
Esegui l'upgrade delle dipendenze di Kf.
Esegui l'upgrade di Kf e verifica che sia andato a buon fine.

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 una versione secondaria alla volta. Ad esempio dalla versione 2.0.0 alla versione 2.1.0.
1. Scarica il file YAML della release di Kf e salvalo come kf-release.yaml.
2. Scarica la versione di Kf per il tuo sistema operativo e assegnale il 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, caratteristiche e registri di container.
Modifica kf-release.yaml e mantieni le modifiche che vuoi conservare.

Ad esempio, se imposti la proprietà configmap config-defaults Da spaceDefaultToV3Stack a falso in v2.0.0 di Kf, la release v2.1.0 avrà il valore predefinito di 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 trova la matrice delle dipendenze per versione di Kf a cui stai eseguendo l'upgrade.
Esegui l'upgrade di Tekton:
1. Apri la pagina delle 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. Nel menu a discesa della versione, scegli la versione di Cloud Service Mesh elencata in la matrice delle dipendenze Kf.
3. Segui la guida per eseguire l'upgrade di ASM.

Esegui l'upgrade e verifica Kf

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

Se il comando non va a buon fine con il messaggio Error: environment failed checks, segui le indicazioni nell'output doctor per risolvere il problema e riprova a eseguire il comando finché non va a buon fine.
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 del precedente Kf e utilizzo approvato 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