Versione 2.9

Versioni disponibili

2.11 - Ultima versione
2.10
2.9
2.7 - EOL/Non supportata
2.6 - EOL/Non supportata
2.8 - EOL/Non supportata
2.5 - EOL/Non supportata
2.4 - EOL/Non supportata
2.3 - EOL/Non supportata
2.2 - EOL/Non supportata
2.1 - EOL/Non supportata

Questa pagina è stata tradotta dall'API Cloud Translation.

Eseguire l'upgrade di Kf su Google Cloud

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

Nell'ambito della procedura di upgrade, assicurati che il tuo Kf utilizza la versione più recente dell'operatore Kf:

Conferma che è possibile eseguire l'upgrade della tua versione Kf attuale Kf versione 2.9.0.
Esegui l'upgrade a Kf 2.9.0.
Esegui l'upgrade delle dipendenze (se necessario).

Prima di iniziare

Ti serviranno:

Un cluster esistente con Kf installato.
Accedi a una macchina 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

Verifica che le versioni attuali della CLI di Kf e del server corrispondano

Esegui kf debug, convalida l'interfaccia a riga di comando Kf e Le versioni server Kf corrispondono.

La versione dell'interfaccia a riga di comando è indicata in Kf Client.
La versione del server Kf è indicata in kf["app.kubernetes.io/version"].

$ kf debug
...
Version:
  Kf Client:                        v2.7.3
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.7.3
...

Se il client Kf e il server Kf non corrispondono, ma la versione del server è v2.7.x. Prima di continuare, installa l'interfaccia a riga di comando Kf v2.9.0.

Se il valore del server Kf è precedente alla versione 2.7.x, devi prima eseguire l'upgrade incrementale alla versione 2.7.x di Kf per continuare.

Verificare che Kf sia in buono stato prima di eseguire l'upgrade

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 messaggi FAIL o Error: environment failed checks, segui le istruzioni nell'output kf doctor oppure visualizza la guida alla risoluzione dei problemi per risolvere il problema e riprova a eseguire il comando fino a quando non avrà esito positivo.

Eseguire l'upgrade dell'operatore

L'operatore Kf esegue gli upgrade per tuo conto.

Applica il file yaml dell'operatore:

Nota: questa operazione inizia immediatamente ed è irreversibile.
```
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.9.0/operator.yaml"
```

Esegui l'upgrade delle dipendenze Kf

Esegui l'upgrade di Tekton:

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

Esegui l'upgrade a Cloud Service Mesh v1.12:
1. Segui i passaggi descritti nella guida all'upgrade di Cloud Service Mesh.

Esegui l'upgrade/l'installazione di Config Connector:

Per l'upgrade da Kf 2.8: segui i passaggi descritti nel passaggio "Installa il connettore di configurazione" in Installazione di Kf

Per eseguire l'upgrade da Kf 2.7:
1. Scarica il file tar dell'operatore Config Connector richiesto.
  
  Nota: conserva una copia del bundle di installazione perché ti serve questo bundle per disinstallare Config Connector.
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 2.9.0

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 nella scheda Cloud Shell per installarlo autonomamente.
```
gcloud storage cp gs://kf-releases/v2.9.0/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.
```
gcloud storage cp gs://kf-releases/v2.9.0/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
gcloud storage cp gs://kf-releases/v2.9.0/kf-linux ~/bin/kf
chmod a+x ~/bin/kf
echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc
source ~/.bashrc
```
Windows
Verrà scaricato kf nella directory corrente. Aggiungila al percorso se vuoi chiamarla da un punto diverso dalla directory corrente.
```
gcloud storage cp gs://kf-releases/v2.9.0/kf-windows.exe kf.exe
```
convalida l'interfaccia a riga di comando Kf Le versioni server Kf corrispondono:
- 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.9.0
  Server version:                   v1.21.6-gke.1500
  kf["app.kubernetes.io/version"]:  v2.9.0
...
```

Verificare che l'upgrade di Kf sia andato a buon fine

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

Se i passaggi di verifica vengono superati, l'upgrade del cluster è andato a buon fine. In caso di problemi, consulta la pagina di assistenza per avere indicazioni.