Agrega y administra grupos de nodos

En esta página, se muestra cómo agregar y realizar operaciones en grupos de nodos a través de la ejecución de los clústeres Standard de Google Kubernetes Engine (GKE). Para obtener información sobre cómo funcionan los grupos de nodos, consulta Información sobre grupos de nodos.

Los clústeres pueden realizar operaciones, como el aprovisionamiento automático de nodos, en varios grupos de nodos en paralelo. Puedes crear, actualizar o borrar un grupo de nodos de forma manual mientras se crea, actualiza o borra otro grupo de nodos.

Estas instrucciones no se aplican a los clústeres de Autopilot, en los que GKE administra los nodos y no hay grupos de nodos que administres. Para obtener más información, consulta la Descripción general 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 gcloud components update para obtener la versión más reciente.

Agrega un grupo de nodos a un clúster Standard

Puedes agregar un grupo de nodos nuevo a un clúster de GKE Standard a través de gcloud CLI, la consola de Google Cloud o Terraform. GKE también es compatible con el aprovisionamiento automático de nodos, que administra de forma automática los grupos de nodos de tu clúster según los requisitos de escalamiento.

Como práctica recomendada en ambos casos, te recomendamos que crees y uses una cuenta de servicio de Identity and Access Management (IAM) con privilegios mínimos para que la usen tus grupos de nodos en lugar de la Cuenta de servicio predeterminada de Compute Engine. Para obtener instrucciones sobre cómo crear una cuenta de servicio con privilegios mínimos, consulta Endurece la seguridad del clúster.

gcloud container node-pools create POOL_NAME \
    --cluster CLUSTER_NAME \
    --service-account SERVICE_ACCOUNT

Creating node pool POOL_NAME...done.
Created [https://container.googleapis.com/v1/projects/PROJECT_ID/zones/us-central1/clusters/CLUSTER_NAME/nodePools/POOL_NAME].
NAME: POOL_NAME
MACHINE_TYPE: e2-medium
DISK_SIZE_GB: 100
NODE_VERSION: 1.21.5-gke.1302

gcloud container node-pools list --cluster CLUSTER_NAME

resource "google_container_node_pool" "default" {
  name    = "gke-standard-regional-node-pool"
  cluster = google_container_cluster.default.name

  node_config {
    service_account = google_service_account.default.email
  }
}

Visualiza grupos de nodos en un clúster Standard

gcloud container node-pools list --cluster CLUSTER_NAME

gcloud container node-pools describe POOL_NAME \
    --cluster CLUSTER_NAME

Escalar un grupo de nodos

Puedes aumentar o reducir la escala de tus grupos de nodos para optimizar el rendimiento y los costos. Con los grupos de nodos de GKE Standard, puedes hacer lo siguiente: escalar un grupo de nodos de forma horizontal a través del cambio de la cantidad de nodos en el grupo de nodos o escalar verticalmente un grupo de nodos a través del cambio de la configuración del atributo de la máquina de los nodos.

Cambia el recuento de nodos para escalar horizontalmente

gcloud container clusters resize CLUSTER_NAME \
    --node-pool POOL_NAME \
    --num-nodes NUM_NODES

Cambia los atributos de la máquina de los nodos para escalar verticalmente

Puedes modificar el tipo de máquina configurado, el tipo y el tamaño del disco del grupo de nodos.

Cuando editas uno o más de estos atributos de máquina, GKE actualiza los nodos a la nueva configuración mediante la estrategia de actualización configurada para el grupo de nodos. Si configuras la estrategia de actualización azul-verde, puedes migrar las cargas de trabajo de los nodos originales a los nuevos mientras puedes revertir los nodos originales si la migración falla. Inspecciona la configuración de actualización del grupo de nodos para asegurarte de que la estrategia configurada sea la forma en la que deseas que se actualicen los nodos.

Actualiza al menos uno de los atributos de máquina destacados en el siguiente comando:

gcloud container node-pools update POOL_NAME \
    --cluster CLUSTER_NAME \
    --machine-type MACHINE_TYPE \
    --disk-type DISK_TYPE \
    --disk-size DISK_SIZE

Omite las marcas para los atributos de máquina que no deseas cambiar. Sin embargo, debes usar al menos una marca de atributo de máquina, si es que el comando falla.

Reemplaza lo siguiente:

• POOL_NAME: el nombre del grupo de nodos al que se cambiará el tamaño
• CLUSTER_NAME: el nombre del clúster al que se cambiará el tamaño
• MACHINE_TYPE: el tipo de máquina que se usará para los nodos. Para obtener más información, consulta gcloud container node-pools update.
• DISK_TYPE: el tipo de disco de arranque de la VM del nodo debe ser pd-standard, pd-ssd o pd-balanced.
• DISK_SIZE: Es el tamaño de los discos de arranque de VM de los nodos en GB. El valor predeterminado es 100 GB.

Actualiza un grupo de nodos

De forma predeterminada, los nodos de un clúster tienen habilitada la actualización automática y se recomienda no inhabilitarla . Las actualizaciones automáticas de nodos garantizan que el plano de control y la versión de los nodos del clúster permanezcan sincronizados y cumplan con la política de sesgo de versiones de Kubernetes, que garantiza que los planos de control sean compatibles con los nodos de hasta dos versiones secundarias anteriores a la del plano de control. Por ejemplo, los planos de control de Kubernetes 1.29 son compatibles con los nodos de Kubernetes 1.27.

Con las actualizaciones del grupo de nodos de GKE, puedes elegir entre dos estrategias de actualización configurables, llamadas actualizaciones de aumento y actualizaciones azul-verde.

Elige una estrategia y usa los parámetros para ajustar la estrategia a fin de que se adapte mejor a las necesidades de tu entorno del clúster.

Mientras se actualiza un nodo, GKE deja de programar pods nuevos en él y, en cambio, intenta programar sus pods en ejecución en otros nodos. Esto es similar a otros eventos que recrean el nodo, como la habilitación o inhabilitación de una función en el grupo de nodos.

La actualización se completará cuando se vuelvan a crear todos los nodos y el clúster se encuentre en el estado deseado. Cuando un nodo recién actualizado se registra con el plano de control, GKE marca el nodo como programable.

Las instancias de nodo nuevas ejecutan la versión deseada de Kubernetes y también los elementos siguientes:

• La imagen de nodo
• kubelet
• kube-proxy

Actualiza un grupo de nodos de forma manual

Puedes actualizar la versión de un grupo de nodos de forma manual para que coincida con la versión del plano de control o con una versión inferior que aún esté disponible y que sea compatible con el plano de control. Puedes actualizar varios grupos de nodos en paralelo de forma manual, mientras que GKE actualiza de manera automática solo un grupo de nodos a la vez.

Cuando actualizas de forma manual un grupo de nodos, GKE quita las etiquetas que agregaste a los nodos individuales mediante kubectl. Para evitar esto, aplica etiquetas a los grupos de nodos en su lugar.

Puedes actualizar tus grupos de nodos de forma manual a una versión compatible con el plano de control mediante la consola de Google Cloud o Google Cloud CLI.

gcloud container clusters upgrade CLUSTER_NAME \
  --node-pool=NODE_POOL_NAME

gcloud container clusters upgrade CLUSTER_NAME \
  --node-pool=NODE_POOL_NAME \
  --cluster-version VERSION

Implementa un Pod en un grupo de nodos específico

Puedes implementar un Pod de forma explícita en un grupo de nodos específico mediante un nodeSelector en el manifiesto del Pod. nodeSelector programa Pods en nodos con una etiqueta coincidente.

Todos los grupos de nodos de GKE tienen etiquetas con el siguiente formato: cloud.google.com/gke-nodepool: POOL_NAME. Agrega esta etiqueta al campo nodeSelector en el Pod, como se muestra en el siguiente ejemplo:

apiVersion: v1
kind: Pod
metadata:
  name: nginx
  labels:
    env: test
spec:
  containers:
  - name: nginx
    image: nginx
    imagePullPolicy: IfNotPresent
  nodeSelector:
    cloud.google.com/gke-nodepool: POOL_NAME

Para obtener más información, consulta Asigna Pods a nodos.

Como alternativa al selector de nodos, puedes usar la afinidad de nodos. Usa la afinidad de nodos si quieres una regla menos estricta en la que el Pod intenta cumplir con la restricción, pero aún está programado, incluso si la restricción no puede satisfacerse. Para obtener más información, consulta Afinidad de nodos. También puedes especificar las solicitudes de recursos para los contenedores.

Cambia un grupo de nodos a una versión inferior

Puedes cambiar un grupo de nodos a una versión inferior, por ejemplo, para mitigar una actualización incorrecta del grupo de nodos. Revisa las limitaciones antes de cambiar a una versión inferior de un grupo de nodos.

1. Configura una exclusión de mantenimiento para el clúster a fin de evitar que GKE actualice el grupo de nodos de forma automática después de cambiar a una versión inferior.
2. Si deseas cambiar a una versión inferior de un grupo de nodos, especifica una versión anterior mientras sigues las instrucciones para actualizar un grupo de nodos de forma manual.

Borra un grupo de nodos

Si borras un grupo de nodos, se borran los nodos y todas las cargas de trabajo en ejecución, sin respetar la configuración de PodDisruptionBudget. Para obtener más información sobre cómo esto afecta tus cargas de trabajo, incluidas las interacciones con selectores de nodos, consulta Borra grupos de nodos.

gcloud container node-pools delete POOL_NAME \
    --cluster CLUSTER_NAME

Solucionar problemas

Para obtener información sobre la solución de problemas, consulta Soluciona problemas de grupos de nodos estándar y Soluciona problemas de registro de nodos.

¿Qué sigue?

• Obtén información sobre cómo funcionan los grupos de nodos.
• Obtén más información sobre el aprovisionamiento automático de grupos de nodos.
• Obtén información sobre cómo configurar kubelet y sysctl con la configuración del sistema de nodos.