Especifica una imagen de nodo

Estándar

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 nodo y los tipos de imágenes de nodo disponibles, consulta Imágenes de nodo.

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 de 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 que se describen en este documento.
  Nota: Para las instalaciones de gcloud CLI existentes, asegúrate de configurar la propiedad compute/region. Si usas principalmente clústeres zonales, configura compute/zone en su lugar. Cuando configuras una ubicación predeterminada, puedes evitar errores en gcloud CLI como el siguiente: One of [--zone, --region] must be supplied: Please specify location. Es posible que debas especificar la ubicación en ciertos comandos si la ubicación de tu clúster difiere de la predeterminada que estableciste.

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.

Nota: A partir de la versión 1.19 de nodo de GKE, la imagen de nodo predeterminada para los nodos de Linux es la variante Container-Optimized OS con Containerd (cos_containerd). en lugar de la variante Container-Optimized OS con Docker (cos).

Advertencia: En la versión 1.24 de GKE y posteriores, los tipos de imagen de nodo basados en Docker no son compatibles. En la versión 1.23 de GKE, tampoco puedes crear grupos de nodos nuevos con tipos de imágenes de nodo de Docker. Debes migrar a un tipo de imagen de nodo de containerd. Para obtener más información sobre este cambio, consulta Acerca de la baja de la imagen de nodo de Docker.

Crea 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:

• CLUSTER_NAME: el nombre que eliges para el clúster
• IMAGE_TYPE: Es el nombre de tu tipo de imagen de nodo.

Console

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

   Ir a Crea 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

Advertencia: En la versión 1.24 de GKE y posteriores, los tipos de imagen de nodo basados en Docker no son compatibles. En la versión 1.23 de GKE, tampoco puedes crear grupos de nodos nuevos con tipos de imágenes de nodo de Docker. Debes migrar a un tipo de imagen de nodo de containerd. Para obtener más información sobre este cambio, consulta Acerca de la baja de la imagen de nodo de Docker.

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

Precaución: GKE comienza de inmediato a volver a crear los nodos para este cambio con la estrategia de actualización de nodos, independientemente de las políticas de mantenimiento activas. GKE depende de la disponibilidad de recursos para el cambio. Inhabilitar las actualizaciones automáticas de nodos no impide este cambio. Asegúrate de que las cargas de trabajo que se ejecutan en los nodos estén preparadas para las interrupciones antes de iniciar este cambio.

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 consola de Google Cloud .

   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?

• Más información sobre las imágenes de nodo.
• Más información sobre los grupos de nodos