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).

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 gcloud components update para obtener la versión más reciente.
  Nota: Para las instalaciones de gcloud CLI existentes, asegúrate de configurar las propiedades compute/region y compute/zone. Cuando configuras las ubicaciones predeterminadas, puedes evitar errores en gcloud CLI como el siguiente: One of [--zone, --region] must be supplied: Please specify location.

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_NAME: 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. Haz clic en Crear.

3. Configura tu clúster como desees.

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

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

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

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

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.

GKE usa la estrategia de actualización de nodos y la configuración seleccionadas para actualizar la imagen de un nodo. Si deseas obtener más información sobre cómo elegir la estrategia de actualización de grupos de nodos óptima y la configuración para tu entorno, consulta las estrategias de actualización de grupos 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_NAME: 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