Versione 2.6

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 Kf esistente e delle sue dipendenze.

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

Verifica che la tua versione attuale di Kf possa eseguire l'upgrade alla versione 2.6.1 di Kf.
Aggiornamento a Kf v2.6.1.
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 sotto 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
...

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

Se il valore del server Kf è precedente alla v2.5.x, per continuare è necessario prima eseguire l'upgrade incrementale a Kf v2.5.x.

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 visualizzi messaggi 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 viene eseguito correttamente.

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.6.1/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.26.0/release.yaml"

Esegui l'upgrade all'ultima versione di Cloud Service Mesh:
1. Segui i passaggi descritti nella guida all'upgrade di Cloud Service Mesh.

Esegui l'upgrade di Config Connector.
1. Scarica il file tar dell'operatore Config Connector richiesto.
  
  Nota: conserva una copia del bundle di installazione perché ti servirà 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 v2.6.1

Installa l'interfaccia a riga di comando:
Linux
Questo comando installa la CLI di Kf per tutti gli utenti del sistema. Segui le istruzioni nella scheda Cloud Shell per installarlo solo per te.
```
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
Questo comando installa kf per tutti gli utenti del sistema.
```
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
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.6.1/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 voglio chiamare se da una posizione diversa dalla directory attuale.
```
gcloud storage cp gs://kf-releases/v2.6.1/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.6.1
  Server version:                   v1.21.3-gke.2001
  kf["app.kubernetes.io/version"]:  v2.6.1
...
```

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 tentativi non vadano 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.

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