Specifica un'immagine del nodo

Standard

---

Questa pagina mostra come specificare un'immagine del nodo per i nodi dei cluster in modalità standard di Google Kubernetes Engine (GKE). Per scoprire come funzionano le immagini dei nodi e i tipi di immagini dei nodi disponibili, consulta Immagini dei nodi.

I nodi dei cluster GKE Autopilot utilizzano sempre l'immagine del nodo Container-Optimized OS con containerd (cos_containerd).

Prima di iniziare

Prima di iniziare, assicurati di aver eseguito le seguenti operazioni:

• Attiva l'API Google Kubernetes Engine.
Attiva l'API Google Kubernetes Engine
• Se vuoi utilizzare Google Cloud CLI per questa attività, installa e poi inizializza gcloud CLI. Se hai già installato gcloud CLI, ottieni la versione più recente eseguendo gcloud components update.
  Nota: per le installazioni esistenti di gcloud CLI, assicurati di impostare le proprietà compute/region e compute/zone. Se imposti le posizioni predefinite, puoi evitare errori in gcloud CLI come il seguente: One of [--zone, --region] must be supplied: Please specify location.

Specifica di un'immagine del nodo

Puoi selezionare l'immagine del nodo da utilizzare quando crei un nuovo cluster oppure puoi modificare l'immagine del nodo di un cluster esistente.

Nota: a partire dalla versione 1.19 del nodo GKE, l'immagine del nodo predefinita per i nodi Linux è la variante Container-Optimized OS con Containerd (cos_containerd) anziché la variante Container-Optimized OS con Docker (cos).

Avviso: nella versione 1.24 e successive di GKE, i tipi di immagini dei nodi basate su Docker non sono supportati. Nella versione 1.23 di GKE, non puoi nemmeno creare nuovi node pool con tipi di immagini dei nodi Docker. Devi eseguire la migrazione a un tipo di immagine del nodo containerd. Per approfondire questa modifica, consulta Informazioni sulla deprecazione delle immagini dei nodi Docker.

Creazione di un nuovo cluster

gcloud

Per creare un nuovo cluster con un'immagine del nodo specifica, esegui il seguente comando:

gcloud container clusters create CLUSTER_NAME --image-type IMAGE_TYPE

Sostituisci quanto segue:

• CLUSTER_NAME: il nome scelto per il cluster.
• IMAGE_TYPE: il nome del tipo di immagine del nodo.

Console

1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

   Vai a Google Kubernetes Engine

2. Fai clic su Crea.

3. Configura il cluster come preferisci.

4. Nel riquadro di navigazione, in Pool di nodi, fai clic su Nodi.

5. Nell'elenco a discesa Tipo immagine, seleziona l'immagine del nodo che ti interessa.

6. Fai clic su Crea.

Terraform

Per creare un nuovo cluster con un'immagine del nodo specifica utilizzando Terraform, consulta il seguente esempio:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-node-image"
  initial_node_count = 2

  node_config {
    image_type = "cos_containerd"
  }

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

Per scoprire di più sull'utilizzo di Terraform, consulta Assistenza di Terraform per GKE.

Eseguire l'upgrade di un cluster esistente

Avviso: nella versione 1.24 e successive di GKE, i tipi di immagini dei nodi basate su Docker non sono supportati. Nella versione 1.23 di GKE, non puoi nemmeno creare nuovi node pool con tipi di immagini dei nodi Docker. Devi eseguire la migrazione a un tipo di immagine del nodo containerd. Per approfondire questa modifica, consulta Informazioni sulla deprecazione delle immagini dei nodi Docker.

Questa modifica richiede la ricreazione dei nodi, il che può causare interruzioni dei carichi di lavoro in esecuzione. Per informazioni dettagliate su questa modifica specifica, individua la riga corrispondente nella tabella Modifiche manuali che ricreano i nodi utilizzando una strategia di upgrade dei nodi senza rispettare i criteri di manutenzione. Per scoprire di più sugli aggiornamenti dei nodi, consulta Pianificare le interruzioni per gli aggiornamenti dei nodi.

Attenzione: GKE inizia immediatamente a ricreare i nodi per questa variazione utilizzando la strategia di upgrade dei nodi, indipendentemente dai criteri di manutenzione attiva. GKE dipende dalla disponibilità delle risorse per la modifica. La disattivazione degli upgrade automatici dei nodi non impedisce questa variazione. Assicurati che i carichi di lavoro in esecuzione sui nodi siano preparati all'interruzione prima di iniziare questa modifica.

gcloud

Puoi eseguire l'upgrade di un cluster esistente in modo che utilizzi un'immagine del nodo specifica utilizzando il comando gcloud container clusters upgrade. Puoi eseguire l'upgrade di tutti i pool di nodi nel cluster oppure puoi specificare un pool di nodi specifico utilizzando --node-pool.

Per eseguire l'upgrade di un cluster esistente in modo che utilizzi un'immagine del nodo specifica, esegui il comando seguente:

gcloud container clusters upgrade CLUSTER_NAME --image-type IMAGE_TYPE \
    [--node-pool POOL_NAME]

Sostituisci quanto segue:

• CLUSTER_NAME: il nome del cluster esistente.
• POOL_NAME: il nome del pool di nodi da aggiornare.
• IMAGE_TYPE: il nome del tipo di immagine del nodo.

Console

1. Vai alla pagina Google Kubernetes Engine nella console Google Cloud.

   Vai a Google Kubernetes Engine

2. Nell'elenco dei cluster, fai clic sul nome del cluster da modificare.

3. Fai clic sulla scheda Nodi.

4. In Pool di nodi, fai clic sul nome del pool di nodi di cui vuoi eseguire l'upgrade.

5. Nella pagina Dettagli del pool di nodi, fai clic su Modifica.

6. In Versione nodo, fai clic su Cambia.

7. Seleziona la versione del nodo che ti interessa e fai clic su Cambia per avviare l'upgrade.

Passaggi successivi

• Scopri di più sulle immagini dei nodi.
• Scopri di più sui pool di nodi.