Nell'ambito della procedura di upgrade, assicurati che l'installazione di Kf utilizzi la versione più recente dell'operatore Kf:
- Verifica che la tua versione attuale di Kf possa eseguire l'upgrade alla versione 2.10.0 di Kf.
- Esegui l'upgrade a Kf 2.10.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
ekubectl
.
Prepararsi per l'upgrade
Connettiti al cluster di destinazione
gcloud container clusters get-credentials CLUSTER_NAME \
--zone CLUSTER_ZONE \
--project CLUSTER_PROJECT_ID
Conferma che le attuali versioni dell'interfaccia a riga di comando 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 è elencata sotto
Kf Client
. - La versione del server Kf è indicata sotto
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 i valori del client Kf e del server Kf non corrispondono, ma la versione del server è 2.7.x, installa l'interfaccia a riga di comando Kf 2.10.0 prima di continuare.
Se il valore del server Kf è precedente alla v2.7.x, per continuare è necessario prima eseguire l'upgrade incrementale a Kf v2.7.x.
Verificare che Kf sia in buono stato prima di eseguire l'upgrade
Esegui kf doctor
per verificare 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.
Esegui l'upgrade dell'operatore
L'operatore Kf esegue gli upgrade per tuo conto.
Applica il file YAML dell'operatore:
kubectl apply -f "https://storage.googleapis.com/kf-releases/v2.10.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:
- 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:
Scarica il file tar dell'operatore Config Connector richiesto.
Estrai il file tar.
tar zxvf release-bundle.tar.gz
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.10.0
Installa l'interfaccia a riga di comando:
Linux
Questo comando installa la CLI di Kf per tutti gli utenti del sistema. Segui le nella scheda Cloud Shell per installarlo autonomamente.
gcloud storage cp gs://kf-releases/v2.10.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.10.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 utilizzibash
, potrebbe essere necessario modificare le istruzioni per altre shell.mkdir -p ~/bin
gcloud storage cp gs://kf-releases/v2.10.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.10.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 è elencata sotto
Kf Client
. - La versione del server Kf è indicata sotto
kf["app.kubernetes.io/version"]
.
$ kf debug ... Version: Kf Client: v2.10.0 Server version: v1.21.6-gke.1500 kf["app.kubernetes.io/version"]: v2.10.0 ...
- La versione dell'interfaccia a riga di comando è elencata sotto
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 i controlli del cluster più volte. È 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'outputdoctor
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 è stato eseguito correttamente. In caso di problemi, consulta la pagina di assistenza per avere indicazioni.