Spécifier une image de nœud

Standard

---

Vous trouverez sur cette page la procédure à suivre pour spécifier une image de nœud pour les nœuds des clusters en mode standard Google Kubernetes Engine (GKE). Pour en savoir plus sur le fonctionnement des images de nœuds et sur les types d'images de nœuds disponibles, consultez la page Images de nœuds.

Les nœuds des clusters GKE Autopilot utilisent toujours l'image de nœud Container-Optimized OS avec containerd (cos_containerd).

Avant de commencer

Avant de commencer, effectuez les tâches suivantes :

• Activez l'API Google Kubernetes Engine.
Activer l'API Google Kubernetes Engine
• Si vous souhaitez utiliser Google Cloud CLI pour cette tâche, installez puis initialisez gcloud CLI. Si vous avez déjà installé gcloud CLI, assurez-vous de disposer de la dernière version en exécutant la commande gcloud components update.
  Remarque : Pour les installations de gcloud CLI existantes, veillez à définir les propriétés compute/region et compute/zone. En définissant des emplacements par défaut, vous pouvez éviter les erreurs gcloud CLI telles que celle-ci : One of [--zone, --region] must be supplied: Please specify location.

Spécifier une image de nœud

Vous pouvez sélectionner l'image de nœud que vous souhaitez utiliser lorsque vous créez un cluster, ou vous pouvez modifier l'image de nœud d'un cluster existant.

Remarque : À partir de la version 1.19 du nœud GKE, l'image de nœud par défaut pour les nœuds Linux est la variante Container-Optimized OS avec containerd (cos_containerd), au lieu de la variante Container-Optimized OS avec Docker (cos).

Avertissement : Dans GKE 1.24 et versions ultérieures, les types d'images de nœuds basés sur Docker ne sont pas acceptés. Dans GKE version 1.23, vous ne pouvez pas non plus créer de pools de nœuds avec des types d'images de nœuds Docker. Vous devez migrer vers un type d'image de nœud containerd. Pour en savoir plus sur cette modification, consultez la page À propos de l'abandon de l'image de nœud Docker.

Créer un cluster

gcloud

Pour créer un cluster avec une image de nœud spécifique, exécutez la commande suivante :

gcloud container clusters create CLUSTER_NAME --image-type IMAGE_TYPE

Remplacez l'élément suivant :

• CLUSTER_NAME : nom choisi pour le cluster.
• IMAGE_NAME: nom de votre type d'image de nœud.

Console

1. Accédez à la page Google Kubernetes Engine dans Google Cloud Console.

   Accéder à Google Kubernetes Engine

2. Cliquez sur Créer.

3. Configurez le cluster selon vos besoins.

4. Dans le volet de navigation, cliquez sur Nœuds sous Pools de nœuds.

5. Dans la liste déroulante Type d'image, sélectionnez l'image de nœud souhaitée.

6. Cliquez sur Créer.

Terraform

Pour créer un cluster avec une image de nœud spécifique à l'aide de Terraform, reportez-vous à l'exemple suivant:

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
}

Pour en savoir plus sur l'utilisation de Terraform, consultez la page Compatibilité de Terraform avec GKE.

Mettre à niveau un cluster existant

Avertissement : Dans GKE 1.24 et versions ultérieures, les types d'images de nœuds basés sur Docker ne sont pas acceptés. Dans GKE version 1.23, vous ne pouvez pas non plus créer de pools de nœuds avec des types d'images de nœuds Docker. Vous devez migrer vers un type d'image de nœud containerd. Pour en savoir plus sur cette modification, consultez la page À propos de l'abandon de l'image de nœud Docker.

GKE utilise la stratégie et la configuration sélectionnées de mise à niveau de nœuds pour mettre à niveau l'image d'un nœud. Pour savoir comment choisir la stratégie et la configuration optimales de mise à niveau de nœuds pour votre environnement, consultez la page Stratégies de mise à niveau de nœuds.

gcloud

Vous pouvez mettre à niveau un cluster existant afin d'utiliser une image de nœud spécifique à l'aide de la commande gcloud container clusters upgrade. Vous pouvez mettre à niveau tous les pools de nœuds du cluster ou indiquer un pool de nœuds spécifique à l'aide de --node-pool.

Pour mettre à niveau un cluster existant de sorte qu'il utilise une image de nœud spécifique, exécutez la commande suivante :

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

Remplacez l'élément suivant :

• CLUSTER_NAME : nom de votre cluster existant.
• POOL_NAME : nom du pool de nœuds que vous souhaitez mettre à niveau.
• IMAGE_NAME: nom de votre type d'image de nœud.

Console

1. Accédez à la page Google Kubernetes Engine dans Google Cloud Console.

   Accéder à Google Kubernetes Engine

2. Dans la liste des clusters, cliquez sur le nom du cluster que vous souhaitez modifier.

3. Cliquez sur l'onglet Nœuds.

4. Sous Pools de nœuds, cliquez sur le nom du pool de nœuds que vous souhaitez inspecter.

5. Sur la page Détails du pool de nœuds, cliquez sur Modifier.

6. Sous Version du nœud, cliquez sur Modifier.

7. Sélectionnez la version de nœud souhaitée, puis cliquez sur Modifier pour lancer la mise à niveau.

Étape suivante

• Obtenez plus d'informations sur les images de nœuds.
• En savoir plus sur les pools de nœuds.