Preparati per l'upgrade dell'installazione precedente di Knative e per la migrazione dei tuoi carichi di lavoro configurando il tuo ambiente a riga di comando, creando variabili di ambiente e scaricando lo script di migrazione.
Prima di iniziare
Prima di eseguire l'upgrade, devi esaminare e assicurarti di soddisfare i requisiti.
Per impostazione predefinita, Cloud Shell include le versioni più recenti dei comandi
gcloud
ekubectl
. Se scegli di utilizzare l'ambiente a riga di comando della tua macchina locale, devi assicurarti di soddisfare i seguenti requisiti minimi:gcloud
versione 346.0.0 o successive- Client di
kubectl
versione 1.21 o successive
Scopri di più sulla configurazione degli strumenti a riga di comando
I passaggi di preparazione indicati in questa pagina sono richiesti durante tutta la procedura di upgrade e migrazione.
Importante: tutti i comandi utilizzati durante il processo si basano sulle variabili di ambiente impostate di seguito. Ad esempio, se chiudi Cloud Shell o il timeout della sessione, devi assicurarti che le variabili di ambiente richieste vengano reimpostate.
configura il tuo ambiente
Per utilizzare Cloud Shell, aprilo nella console Google Cloud:
Importante: Cloud Shell ha limiti di utilizzo e può scadere. In caso di timeout della sessione, devi assicurarti che le variabili di ambiente richieste vengano reimpostate.
Crea le seguenti variabili di ambiente obbligatorie:
Imposta le variabili per i dettagli del progetto e del cluster Google Cloud:
export PROJECT_ID=PROJECT_ID export CLUSTER_NAME=CLUSTER_NAME export CLUSTER_LOCATION=CLUSTER_LOCATION
Sostituisci quanto segue:
- PROJECT_ID con l'ID del tuo progetto Google Cloud.
- CLUSTER_NAME con l'ID del cluster o l'identificatore completo del cluster.
- CLUSTER_LOCATION con l'area geografica o la zona in cui si trova il cluster.
A seconda della configurazione, devi identificare il gateway in entrata che gestisce il traffico nel cluster. È importante identificare quale versione di Istio è effettivamente configurata per gestire il traffico.
Se utilizzi la versione in bundle di Istio, verifica che il nome del servizio in entrata sia
istio-ingress
nello spazio dei nomigke-system
:kubectl get svc istio-ingress -n gke-system
Risultato: vengono restituiti i dettagli della configurazione.
Se hai installato il "componente aggiuntivo Istio", devi determinare quale gateway in entrata è configurato e gestisce attivamente il traffico ottenendo gli indirizzi IP dei servizi e identificando quello configurato sul tuo dominio.
Recupera l'indirizzo
EXTERNAL-IP
per ogni servizio in entrata:Esegui i comandi seguenti per ottenere i dettagli di configurazione dei servizi in entrata "versione in bundle di Istio" (
istio-ingress
) e "componente aggiuntivo Istio" (istio-ingressgateway
):kubectl get svc istio-ingress -n gke-system kubectl get svc istio-ingressgateway -n istio-system
Output di esempio:
Prendi nota del valore di
EXTERNAL-IP
per ogni servizio.NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE istio-ingress LoadBalancer 11.11.1.111 12.345.678.910 15020:31265/TCP,80:30059/TCP,443:32004/TCP 8d NAME TYPE CLUSTER-IP EXTERNAL-IP PORT(S) AGE istio-ingressgateway LoadBalancer 22.22.2.222 10.987.654.321 15021:32747/TCP,80:30695/TCP,443:32695/TCP,15012:32369/TCP,15443:30909/TCP 88d
Identifica quale indirizzo IP esterno è configurato per gestire il traffico attraverso il record DNS del tuo dominio personalizzato:
Vai alla pagina Mappature dei domini di pubblicazione Knative:
Fai clic sull'icona a forma di ellisse verticale con tre puntini a destra del servizio, quindi fai clic su RECORD DNS per visualizzare tutti i record DNS:
Utilizzando l'esempio precedente, il gateway in entrata del componente aggiuntivo Istio è in uso e gestisce il traffico se la configurazione del record DNS è impostata sull'indirizzo IP
10.987.654.321
del servizioistio-ingressgateway
.
Imposta le variabili per il nome e lo spazio dei nomi del servizio in entrata che gestisce il traffico per il tuo cluster:
export INGRESS_NAME=INGRESS_NAME export INGRESS_NAMESPACE=INGRESS_NAMESPACE
Sostituisci quanto segue:
INGRESS_NAME con il nome del servizio in entrata identificato nel passaggio precedente.
INGRESS_NAMESPACE con lo spazio dei nomi del servizio in entrata identificato nel passaggio precedente.
Configura Google Cloud CLI:
gcloud config set project ${PROJECT_ID} gcloud container clusters get-credentials ${CLUSTER_NAME} --region ${CLUSTER_LOCATION}
Per i cluster privati:
Se hai già accesso al tuo cluster privato dal client in cui eseguirai lo script di migrazione, puoi andare al passaggio successivo.
Se nel cluster privato è abilitato
master-authorized-network
, puoi abilitare l'accesso dal client in cui eseguirai lo script di migrazione aggiungendo l'indirizzo IP del client alla lista consentita dimaster-authorized-networks
:gcloud container clusters update ${CLUSTER_NAME} \ --region=${CLUSTER_LOCATION} \ --enable-master-authorized-networks \ --master-authorized-networks $(curl ifconfig.me)/32
Scarica lo script di migrazione della pubblicazione Knative:
TMP_DIR=$(mktemp -d) gsutil cp gs://crfa-to-hub-upgrade/migration-addon.sh $TMP_DIR cd $TMP_DIR chmod +x ./migration-addon.sh
Esegui questo comando per disabilitare la scalabilità a zero, altrimenti la scalabilità non riuscirà e causerà errori quando il nodo master viene aggiornato:
kubectl patch cm config-autoscaler -n knative-serving -p '{"data":{"enable-scale-to-zero": "false"}}'
Tieni presente che l'ultimo passaggio di questo processo di upgrade e migrazione è la riattivazione della "scalabilità a zero".
Passaggi successivi
Disinstalla il componente aggiuntivo di GKE.