Especifica una imagen de nodo

En esta página, verás cómo especificar una imagen de nodo en los clústeres del modo Standard de Google Kubernetes Engine (GKE). Para obtener información sobre cómo funcionan las imágenes de nodos y los tipos de imágenes de nodos que están disponibles, consulta Imágenes de nodos.

Los nodos en los clústeres de Autopilot de GKE siempre usan la imagen de nodo Container-Optimized OS con containerd (cos_containerd). No puedes especificar una imagen de nodo diferente en el modo Autopilot.

Antes de comenzar

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

  • Habilita la API de Google Kubernetes Engine.
    • Habilitar la API de Google Kubernetes Engine
  • Si deseas usar Google Cloud CLI para esta tarea, instala y, luego, inicializa gcloud CLI. Si ya instalaste gcloud CLI, ejecuta el comando gcloud components update para obtener la versión más reciente. Es posible que las versiones anteriores de gcloud CLI no admitan la ejecución de los comandos de este documento.

Especifica una imagen de nodo

Puedes seleccionar la imagen de nodo que desees usar cuando crees un clúster nuevo o puedes modificarla en un clúster existente.

Crear un clúster nuevo:

gcloud

Para crear un clúster nuevo con una imagen de nodo específica, ejecuta el siguiente comando:

gcloud container clusters create CLUSTER_NAME --image-type IMAGE_TYPE

Reemplaza lo siguiente:

Console

  1. En la Google Cloud consola, ve a la página Crear un clúster de Kubernetes.

    Ir a Crear un clúster de Kubernetes

  2. Configura tu clúster como desees.

  3. En el panel de navegación, en Grupos de nodos, haz clic en Nodos.

  4. En la lista desplegable Tipo de imagen, selecciona la imagen de nodo deseada.

  5. Haz clic en Crear.

Terraform

Para crear un clúster nuevo con una imagen de nodo específica con Terraform, consulta el siguiente ejemplo:

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

  node_config {
    image_type = "cos_containerd"
  }
}

Si deseas obtener más información sobre el uso de Terraform, consulta Compatibilidad con Terraform para GKE.

Actualiza un clúster existente

Este cambio requiere volver a crear los nodos, lo que puede causar interrupciones en las cargas de trabajo en ejecución. Para obtener detalles sobre este cambio específico, busca la fila correspondiente en los cambios manuales que vuelven a crear los nodos con una estrategia de actualización de nodos sin respetar las políticas de mantenimiento tabla. Para obtener más información sobre las actualizaciones de nodos, consulta Planifica las interrupciones de las actualizaciones de nodos.

gcloud

Puedes actualizar un clúster existente para usar una imagen de nodo específica mediante el comando gcloud container clusters upgrade. Puedes actualizar todos los grupos de nodos en el clúster o puedes especificar un grupo de nodos específico con --node-pool.

Si deseas actualizar un clúster existente para que use una imagen de nodo específica, ejecuta el comando siguiente:

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

Reemplaza lo siguiente:

  • CLUSTER_NAME: Es el nombre del clúster existente.
  • POOL_NAME: Es el nombre del grupo de nodos que quieres actualizar.
  • IMAGE_TYPE: Es el nombre de tu tipo de imagen de nodo.

Console

  1. Ve a la página de Google Kubernetes Engine en la Google Cloud consola de.

    Ir a Google Kubernetes Engine

  2. En la lista de clústeres, haz clic en el nombre del clúster que deseas modificar.

  3. Haz clic en la pestaña Nodos.

  4. En Grupos de nodos, haz clic en el nombre del grupo de nodos que quieres actualizar.

  5. En la página de Detalles del grupo de nodos, haz clic en Editar.

  6. En Versión del nodo, haz clic en Cambiar.

  7. Selecciona la versión de nodo deseada y haz clic en Cambiar para iniciar la actualización.

¿Qué sigue?