Spécifier une image de nœud

Cette page vous explique comment spécifier une image de nœud pour les nœuds des clusters en mode standard de 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). Vous ne pouvez pas spécifier une autre image de nœud en mode Autopilot.

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.

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.

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 :

Console

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

    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"
  }
}

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

Mettre à niveau un cluster existant

Cette modification nécessite de recréer les nœuds, ce qui peut perturber vos charges de travail en cours d'exécution. Pour en savoir plus sur cette modification spécifique, recherchez la ligne correspondante dans le tableau Modifications manuelles qui recréent les nœuds à l'aide d'une stratégie de mise à niveau des nœuds sans respecter les règles de maintenance. Pour en savoir plus sur les mises à jour des nœuds, consultez Planifier les interruptions liées aux mises à jour des 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_TYPE: nom de votre type d'image de nœud.

Console

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

    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