En este documento, se proporcionan instrucciones para actualizar las etiquetas de nodos y los taints de nodos de Kubernetes de un grupo de nodos existente en un clúster Standard de Google Kubernetes Engine (GKE) con la API de GKE. Las etiquetas de nodos de Kubernetes son distintas de las etiquetas de clúster y de nodos de GKE.
Los taintsy las etiquetasde nodo se encuentran en los metadatos de objetos de los nodos de Kubernetes. Las etiquetas de Kubernetes se usan para programar pods en nodos específicos. Por el contrario, los taints se pueden usar para desviar pods de nodos específicos. Si deseas obtener más información, consulta Configura la separación de cargas de trabajo en GKE.
Con la API de GKE, puedes aplicar actualizaciones a las etiquetas de nodos y los taints de nodos de Kubernetes de un grupo de nodos existente de GKE sin volver a crear el grupo de nodos ni interrumpir las cargas de trabajo en ejecución. La configuración actualizada del grupo de nodos se conserva en GKE, por lo que las futuras actualizaciones del grupo de nodos y los nodos nuevos aprovisionados en el grupo de nodos usarán la configuración nueva.
Para obtener más información sobre cómo los cambios afectan el funcionamiento de un clúster de GKE, consulta Administra los cambios en el ciclo de vida del clúster para minimizar las interrupciones. Para obtener detalles sobre cambios específicos, consulta la sección Tipos de cambios en un clúster de GKE.
Sintaxis de las etiquetas
Las etiquetas de Kubernetes deben cumplir con todos los siguientes requisitos:
- Las claves y los valores de las etiquetas deben cumplir con los requisitos de sintaxis y conjunto de caracteres.
- La longitud del valor que especificas en la marca
--node-labelsde gcloud CLI debe ser menor o igual que 1,024 caracteres.
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 instalaste gcloud CLI anteriormente, ejecuta el comando
gcloud components updatepara 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.
Actualiza las etiquetas de nodo
A fin de actualizar las etiquetas de nodo para un grupo de nodos, usa el siguiente comando:
gcloud container node-pools update NODEPOOL_NAME \
--node-labels=[NODE_LABEL,...] \
--cluster=CLUSTER_NAME
--location=CONTROL_PLANE_LOCATION
[GCLOUD_WIDE_FLAG …]
Reemplaza lo siguiente:
NODEPOOL_NAME: el nombre del grupo de nodos que se actualizará.[NODE_LABEL,...]: las etiquetas de nodo nuevas (por ejemplo,label1=value1,label2=value2).CLUSTER_NAME: el nombre del clústerCONTROL_PLANE_LOCATION: la ubicación de Compute Engine del plano de control de tu clúster. Proporciona una región para los clústeres regionales o una zona para los clústeres zonales.
Actualiza taints de nodo
A fin de actualizar los taints de nodo para un grupo de nodos, usa el siguiente comando:
gcloud container node-pools update NODEPOOL_NAME \
--node-taints=[NODE_TAINT,...] \
--cluster=CLUSTER_NAME
--location=CONTROL_PLANE_LOCATION
[GCLOUD_WIDE_FLAG …]
Reemplaza lo siguiente:
NODEPOOL_NAME: el nombre del grupo de nodos que se actualizará.[NODE_TAINT,...]: los taints de nodo nuevos (por ejemplo,key1=val1:NoSchedule,key2=val2:PreferNoSchedule).CLUSTER_NAME: el nombre del clústerCONTROL_PLANE_LOCATION: la ubicación de Compute Engine del plano de control de tu clúster. Proporciona una región para los clústeres regionales o una zona para los clústeres zonales.