Especificar una imagen de nodo

Estándar

En esta página se explica cómo especificar una imagen de nodo para los nodos de los clústeres en modo estándar 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 hay disponibles, consulte Imágenes de nodos.

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

Antes de empezar

Antes de empezar, asegúrate de que has realizado las siguientes tareas:

• Habilita la API de Google Kubernetes Engine.
Habilitar la API de Google Kubernetes Engine
• Si quieres usar Google Cloud CLI para esta tarea, instálala y, a continuación, inicialízala. Si ya has instalado la gcloud CLI, obtén la versión más reciente ejecutando gcloud components update.
  Nota: Si ya tienes instalada la CLI de gcloud, asegúrate de definir la compute/region propiedad. Si usas principalmente clústeres zonales, define compute/zone en su lugar. Si defines 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 tengas que especificar la ubicación en determinados comandos si la ubicación de tu clúster es diferente de la predeterminada que hayas definido.

Especificar una imagen de nodo

Puedes seleccionar la imagen de nodo que quieras usar al crear un clúster o cambiar la imagen de nodo de un clúster que ya tengas.

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

Advertencia: En la versión 1.24 de GKE y posteriores, no se admiten los tipos de imágenes de nodo basados en Docker. En la versión 1.23 de GKE, tampoco puedes crear grupos de nodos con tipos de imagen 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 el artículo Acerca de la discontinuación de la imagen de nodo de Docker.

Crear un nuevo clúster

gcloud

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

gcloud container clusters create CLUSTER_NAME --image-type IMAGE_TYPE

Haz los cambios siguientes:

• CLUSTER_NAME: el nombre que elijas para el clúster.
• IMAGE_TYPE: el nombre del tipo de imagen de nodo.

Consola

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 el clúster a tu gusto.

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

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

5. Haz clic en Crear.

Terraform

Para crear un clúster con una imagen de nodo específica mediante 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"
  }
}

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

Actualizar un clúster

Advertencia: En la versión 1.24 de GKE y posteriores, no se admiten los tipos de imágenes de nodo basados en Docker. En la versión 1.23 de GKE, tampoco puedes crear grupos de nodos con tipos de imagen 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 el artículo Acerca de la discontinuación de la imagen de nodo de Docker.

Para aplicar este cambio, es necesario volver a crear los nodos, lo que puede provocar interrupciones en las cargas de trabajo en ejecución. Para obtener información sobre este cambio concreto, busca la fila correspondiente en la tabla Cambios manuales que recrean los nodos mediante 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 Planificar interrupciones de actualizaciones de nodos.

Precaución: GKE empieza inmediatamente a recrear los nodos para este cambio mediante 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. Si inhabilitas las actualizaciones automáticas de nodos, no se impedirá 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 para que use una imagen de nodo específica con el comando gcloud container clusters upgrade. Puedes actualizar todos los grupos de nodos del clúster o especificar un grupo de nodos concreto con --node-pool.

Para actualizar un clúster que ya tengas para que use una imagen de nodo específica, ejecuta el siguiente comando:

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

Haz los cambios siguientes:

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

Consola

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

   Ir a Google Kubernetes Engine

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

3. Haz clic en la pestaña Nodos.

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

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

6. En Versión de Node, haz clic en Cambiar.

7. Selecciona la versión del nodo que quieras y haz clic en Cambiar para iniciar la actualización.

Siguientes pasos

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