Questa pagina mostra come eseguire la migrazione dei pool di nodi e di cluster Google Kubernetes Engine (GKE) Standard alle immagini dei nodi che utilizzano il runtime del container containerd.
Panoramica
I nodi Kubernetes utilizzano il runtime del container per avviare, gestire e arrestare i container in esecuzione nei pod. Il runtime containerd è un runtime di container standard di settore supportato da GKE.
Il runtime containerd fornisce l'astrazione a livelli che consente l'implementazione di un ricco set di funzionalità come gVisor e Streaming di immagini per estendere le funzionalità di GKE. Il runtime containerd è considerato più efficiente e sicuro in termini di risorse rispetto al runtime Docker.
Per eseguire la migrazione del runtime del container:
- Identifica i nodi che utilizzano il runtime Docker
- Verificare l'impatto della migrazione
- Cambia l'immagine del nodo
Prima di iniziare
Prima di iniziare, assicurati di aver eseguito le seguenti attività:
- Abilita l'API Google Kubernetes Engine. Abilita l'API Google Kubernetes Engine
- Se vuoi utilizzare Google Cloud CLI per questa attività, installa e initialize gcloud CLI. Se hai già installato gcloud CLI, scarica la versione più recente eseguendo
gcloud components update
.
Identifica i nodi che utilizzano il runtime Docker
Puoi controllare quali nodi utilizzano le immagini dei nodi basate su Docker utilizzando i seguenti metodi:
- Utilizza uno script per eseguire l'iterazione su tutti i nodi in tutti i cluster GKE del progetto Google Cloud.
- Utilizza Google Cloud CLI,
kubectl
o la console Google Cloud per identificare le immagini dei nodi. - Utilizza insight e suggerimenti sul ritiro per identificare cluster e nodi in zone o regioni specifiche in un progetto Google Cloud.
Ti consigliamo di utilizzare uno script per identificare rapidamente tutti i nodi di cui devi eseguire la migrazione.
Usa uno script per identificare i nodi Docker
Lo script seguente viene eseguito su ogni nodo di ogni cluster nei progetti disponibili e ti fornisce suggerimenti attuabili, ad esempio:
- Se è configurato il provisioning automatico dei nodi per le immagini Docker
- Equivalenti consigliati dell'immagine dei nodi containerizzata per la migrazione
- Versioni delle immagini dei nodi suggerite per la migrazione
- Comandi suggeriti da eseguire per eseguire la migrazione delle impostazioni e dei nodi identificati
Lo script ignora i cluster GKE Autopilot, che utilizzano per impostazione predefinita Container-Optimized OS con l'immagine dei nodi containerd.
Esegui questo script:
Identifica le immagini dei nodi utilizzando Google Cloud
Puoi verificare le immagini dei nodi esistenti utilizzando Google Cloud CLI, kubectl
o la console Google Cloud.
gcloud
Esegui questo comando:
gcloud container node-pools list \
--cluster=CLUSTER_NAME \
--format="table(name,version,config.imageType)"
Sostituisci CLUSTER_NAME
con il nome del cluster.
L'output è simile al seguente:
NAME NODE_VERSION IMAGE_TYPE
default-pool 1.19.6-gke.600 UBUNTU
Console
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Nell'elenco dei cluster, fai clic sul nome del cluster che vuoi verificare.
Seleziona la scheda Nodi.
Nella sezione Pool di nodi, controlla il valore nella colonna Tipo di immagine.
kubectl
Esegui questo comando:
kubectl get nodes -o wide
L'output è simile al seguente:
# For Docker runtime
NAME STATUS VERSION OS-IMAGE CONTAINER-RUNTIME
gke-node-1 Ready v1.16.15-gke.6000 Container-Optimized OS from Google docker://19.3.1
gke-node-2 Ready v1.16.15-gke.6000 Container-Optimized OS from Google docker://19.3.1
gke-node-3 Ready v1.16.15-gke.6000 Container-Optimized OS from Google docker://19.3.1
Il valore nella colonna CONTAINER-RUNTIME
mostra il runtime e la versione.
Identifica i cluster utilizzando insight e suggerimenti sul ritiro
GKE rileva l'utilizzo di alcune funzionalità e API deprecate, tra cui le immagini dei nodi basate su Docker. Per saperne di più, consulta Ritiri di GKE.
Nell'ambito del rilevamento dell'utilizzo delle deprecazioni, GKE genera insight e suggerimenti che identificano l'utilizzo delle immagini dei nodi basate su Docker con il sottotipo di insight DEPRECATION_K8S_1_24_DOCKERSHIM
.
Un abbinamento di insight e suggerimenti identifica un cluster con nodi che utilizzano immagini dei nodi basate su Docker. Ogni insight e suggerimento fornisce un elenco di pool di nodi specifici in un cluster che utilizzano immagini dei nodi basate su Docker di cui è necessario eseguire la migrazione alle immagini dei nodi containerd.
Per iniziare, segui le istruzioni per visualizzare gli approfondimenti e i consigli sul ritiro. Per i comandi gcloud CLI, utilizza il flag seguente solo per visualizzare gli insight per questo ritiro:
--filter="insightSubtype:DEPRECATION_K8S_1_24_DOCKERSHIM"
Una volta identificati i pool di nodi del cluster che utilizzano le immagini dei nodi basate su Docker, segui le istruzioni per cambiare l'immagine del nodo in un'immagine dei nodi containerd.
Verificare l'impatto della migrazione
Prima di eseguire la migrazione dei cluster di produzione e dei pool di nodi alle immagini dei nodi che utilizzano containerd, ti consigliamo vivamente di testare l'impatto della migrazione in un ambiente di gestione temporanea per ridurre al minimo il rischio di problemi.
Ti consigliamo di eseguire la migrazione dei nodi indipendentemente dall'upgrade dei nodi, in modo da poter isolare le variabili durante la verifica del funzionamento dei carichi di lavoro con la nuova configurazione. Inoltre, se esegui contemporaneamente l'upgrade del pool di nodi alla versione 1.24, non puoi eseguire il rollback della modifica perché 1.24 non supporta i nodi Docker e non puoi eseguire il downgrade delle versioni secondarie.
Cambia l'immagine del nodo in un'immagine containerd
Se hai utilizzato lo script per identificare i nodi Docker, puoi utilizzare i comandi suggeriti restituiti dallo script per modificare le impostazioni di provisioning automatico dei nodi e le immagini dei nodi passando agli equivalenti containerd.
Puoi anche eseguire la migrazione dei nodi da un tipo di immagine Docker a un tipo di immagine containerd aggiornando il pool di nodi e impostando un'immagine diversa utilizzando gcloud CLI o la console Google Cloud.
GKE utilizza la strategia di upgrade dei nodi selezionata e la configurazione per eseguire la migrazione dell'immagine di un nodo. Per questa migrazione, ti consigliamo di utilizzare la strategia di upgrade blu/verde, in quanto se i carichi di lavoro riscontrano problemi con la nuova immagine del nodo durante l'upgrade, puoi eseguire il rollback all'ambiente precedente con la configurazione originale dell'immagine dei nodi.
gcloud
Esegui questo comando:
gcloud container clusters upgrade CLUSTER_NAME \
--image-type=NODE_IMAGE \
--node-pool=POOL_NAME \
--cluster-version=NODE_VERSION
Sostituisci quanto segue:
NODE_IMAGE
: l'immagine del nodo che vuoi utilizzare i nodi.POOL_NAME
: il nome del pool di nodi di cui eseguire la migrazione.NODE_VERSION
: la versione esistente del pool di nodi. Ti consigliamo di impostare questo flag perché, in caso contrario, GKE tenta di eseguire l'upgrade della versione del pool di nodi alla versione del piano di controllo e di aggiornare l'immagine del nodo nella stessa operazione. Se sul piano di controllo è in esecuzione la versione 1.24, il comando non riesce. Se il piano di controllo esegue la 1.23, il comando ha esito positivo, il che ti impedisce di testare le due modifiche (upgrade della versione e aggiornamento dell'immagine) in modo isolato.
L'output è simile al seguente:
NAME NODE_VERSION IMAGE_TYPE
default-pool 1.23.6-gke.600 UBUNTU_CONTAINERD
Console
Vai alla pagina Google Kubernetes Engine nella console Google Cloud.
Nell'elenco dei cluster, fai clic sul nome del cluster che vuoi verificare.
Fai clic sulla scheda Nodi.
Nella sezione Pool di nodi, fai clic sul nome del pool di nodi che vuoi modificare.
Nella pagina Dettagli del pool di nodi, fai clic su
Modifica.Nella sezione Nodi, in Tipo di immagine, fai clic su Cambia.
Seleziona uno dei tipi di immagini containerd.
Fai clic su Cambia.
Rollback alle immagini dei nodi Docker
Se è stata eseguita la migrazione automatica o manuale dei nodi in nodi containerd e hai riscontrato un problema con i carichi di lavoro, segui questi passaggi per ripristinare le immagini dei nodi Docker:
- Scegli il seguente passaggio a seconda dello stato dell'operazione:
- Se l'operazione è ancora in corso, puoi annullare e eseguire il rollback.
- Se l'operazione è stata completata, consulta i passaggi nella sezione precedente e seleziona l'immagine Docker equivalente.
- Configura un'esclusione di manutenzione per impedire temporaneamente a GKE di ritentare la migrazione.
- Esamina la causa principale del problema in modo da poter eseguire la migrazione da Docker e assicurati che il cluster stia eseguendo una versione supportata di GKE.
- Riprova a cambiare l'immagine del nodo in un'immagine containerd. Se rimuovi l'esclusione della manutenzione, GKE attiverà di nuovo l'operazione.
Aggiornamento delle configurazioni degli strumenti Infrastructure as Code (IaC)
Se utilizzi strumenti IaC come Terraform, Ansible o Pulumi per gestire i cluster GKE, assicurati di aggiornare le tue configurazioni in modo da utilizzare le immagini dei nodi containerizzati per evitare che gli strumenti conciliano lo stato desiderato in precedenza con il nuovo stato effettivo. Ad esempio, il provider GKE Terraform supporta i tipi di immagine configurabili.
Aggiorna le configurazioni in modo che lo strumento non aggiorni di nuovo l'immagine dei nodi a un'immagine dei nodi basata su Docker dopo la migrazione alle immagini dei nodi containerd.
Modifica l'immagine del nodo predefinita per il provisioning automatico dei nodi
Se utilizzi il provisioning automatico dei nodi nel tuo cluster, cambia il tipo di immagine predefinito in un'immagine dei nodi containerd. La modifica del tipo di immagine predefinito si applica solo ai nuovi pool di nodi di cui è stato eseguito il provisioning automatico. Devi modificare manualmente l'immagine del nodo per i pool di nodi di cui è stato eseguito il provisioning automatico esistenti.
Puoi modificare il tipo di immagine di provisioning automatico dei nodi predefinito utilizzando gcloud CLI o un file di configurazione.
gcloud
Esegui questo comando:
gcloud container clusters update CLUSTER_NAME \
--enable-autoprovisioning \
--autoprovisioning-image-type=IMAGE_TYPE
Sostituisci quanto segue:
CLUSTER_NAME
: il nome del cluster da aggiornare.IMAGE_TYPE
: il tipo di immagine dei nodi, che può essere uno dei seguenti:cos_containerd
ubuntu_containerd
File
Puoi utilizzare un file di configurazione YAML per modificare il tipo di immagine dei nodi predefinito per il provisioning automatico dei nodi. Quando utilizzi un file, devi anche specificare i valori massimi per le risorse di CPU e memoria.
Salva il seguente file YAML:
resourceLimits: - resourceType: 'cpu' minimum: 4 maximum: 10 - resourceType: 'memory' maximum: 64 autoprovisioningNodePoolDefaults: imageType: 'IMAGE_TYPE'
Sostituisci
IMAGE_TYPE
con il tipo di immagine containerd.Applica la configurazione:
gcloud container clusters update CLUSTER_NAME \ --enable-autoprovisioning \ --autoprovisioning-config-file=FILE_NAME
Sostituisci
FILE_NAME
con il percorso del file di configurazione.
Risoluzione dei problemi
Per la risoluzione dei problemi e per i problemi noti relativi alle soluzioni alternative, consulta Risoluzione dei problemi relativi al runtime dei container.
Passaggi successivi
- Scopri di più sul provisioning automatico dei nodi.
- Scopri di più sulle immagini dei nodi containerd.