Crea y administra etiquetas de clúster y grupo de nodos

En esta página, se proporciona una descripción general de etiquetas de clúster y etiquetas de grupo de nodos en Google Kubernetes Engine (GKE).

Etiquetas de clúster y nodo de grupo de GKE y de Kubernetes

Las etiquetas de clúster de GKE y de grupos de nodos son distintas de las etiquetas en Kubernetes. Los dos sistemas de etiquetado funcionan de forma independiente y no heredan ni comparten etiquetas.

Las etiquetas de clúster y de grupo de nodos de GKE son metadatos arbitrarios adjuntos a tus recursos que puedes usar para hacer un seguimiento del uso y los datos de facturación.

Por separado, en Kubernetes, el sistema usa etiquetas a nivel interno para asociar los componentes y recursos del clúster (por ejemplo, Pods y nodos) entre sí y administrar los ciclos de vida de los recursos. Puedes editar las etiquetas de Kubernetes mediante la API de Kubernetes. También puedes usar la API de GKE para editar las etiquetas de Kubernetes en tus nodos con la creación de clústeres o con una actualización de clúster.

¿Qué son las etiquetas de clúster?

Una etiqueta de clúster es un par clave-valor que puedes asignar a los clústeres de Google Cloud. Te ayudan a organizar estos recursos y administrar los costos a gran escala, con el nivel de detalle que necesitas. Puedes adjuntar una etiqueta a cada recurso y, luego, usarlas para filtrarlos. La información sobre las etiquetas se envía al sistema de facturación que te permite desglosar los cargos facturados por etiqueta. Con los informes de facturación integrados, puedes filtrar y agrupar costos por etiquetas de recurso. También puedes usar etiquetas para consultar las exportaciones de datos de facturación.

Requisitos para las etiquetas de clúster

Las etiquetas de clúster que se aplican a un recurso deben cumplir con los requisitos siguientes:

• Cada recurso puede tener hasta 64 etiquetas de clúster.
• Cada etiqueta de clúster debe ser un par clave-valor.
• La longitud de las claves debe ser de entre 1 y 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y su longitud máxima es de 63 caracteres.
• Las claves y los valores pueden contener solo letras en minúscula, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar la codificación UTF-8, además, se permiten los caracteres internacionales. Las claves deben comenzar con una letra en minúscula o un carácter internacional.
• La porción de clave de una etiqueta de clúster debe ser única para un solo recurso. Sin embargo, puedes usar la misma clave en varios recursos.

Estos límites se aplican a la clave y al valor de cada etiqueta de clúster, y a los recursos individuales de Google Cloud que tienen etiquetas de clúster. No hay límite para la cantidad de etiquetas de clúster que puedes aplicar en todos los recursos de un proyecto.

Usos comunes de las etiquetas de clúster

Estos son algunos casos prácticos comunes de las etiquetas de clúster:

• Etiquetas de clúster por equipo o del centro de costos: Agrega etiquetas por equipo o centro de costos para distinguir los clústeres que pertenecen a distintos equipos (por ejemplo, team:research y team:analytics). Puedes usar este tipo de etiquetas para la contabilidad de costos o la creación de presupuestos.

• Etiquetas de clúster de componentes: Por ejemplo, component:redis, component:frontend, component:ingest y component:dashboard.

• Etiquetas de clúster de entorno o etapa: Por ejemplo, environment:production y environment:test.

• Etiquetas de clúster de estado : Por ejemplo, state:active, state:readytodelete y state:archive.

• Etiquetas de clúster de propietarios: Se usan para identificar a los equipos responsables de las operaciones, por ejemplo: team:shopping-cart.

• Desglose de facturación: Usa las etiquetas de grupo de nodos para desglosar los cargos facturados por grupo de nodos. Para obtener más información, consulta Ver el desglose detallado de los costos del clúster.

No recomendamos crear grandes cantidades de etiquetas únicas, como marcas de tiempo o valores individuales para cada llamada a la API. El problema con este enfoque es que, cuando los valores cambian con frecuencia o con claves que sobrecargan el catálogo, esto dificulta el filtrado y la generación de informes eficaces para los recursos.

Etiquetas

Las etiquetas se pueden usar como anotaciones que se pueden consultar en los recursos, pero no se pueden usar para establecer condiciones en las políticas. Las etiquetas proporcionan una forma de permitir o rechazar políticas de manera condicional en función de si un recurso tiene una etiqueta específica, ya que proporciona un control detallado sobre las políticas. Para obtener más información, consulta la Descripción general de etiquetas.

Etiquetas aplicadas de manera automática

GKE aplica automáticamente varias etiquetas a los recursos del clúster.

Por ejemplo, GKE aplica etiquetas a las instancias de Compute Engine, los discos persistentes y los aceleradores (TPU).

En la siguiente tabla, se enumeran las etiquetas que GKE aplica de forma automática a los recursos:

No edites ni borres las etiquetas reservadas. Los cambios que realices en las etiquetas reservadas se concilian de forma automática.

Propagación de etiquetas

En GKE, puedes aplicar etiquetas a los clústeres y a los grupos de nodos de modo Standard. Cuando etiquetas un clúster, la etiqueta se propaga a todos los recursos individuales del clúster, como los nodos, las instancias y los discos persistentes. Cuando etiquetas un grupo de nodos, la etiqueta se propaga a todos los recursos individuales del grupo, como las instancias y los discos persistentes. En clústeres de Standard, si las etiquetas del clúster entran en conflicto con las etiquetas del grupo de nodos, como cuando la clave de la etiqueta es la misma, pero el valor es diferente, las etiquetas del grupo de nodos anulan las etiquetas del clúster.

Cualquier etiqueta que apliques a tus clústeres o grupos de nodos se propaga a través de un proceso en segundo plano que se ejecuta por hora. La etiqueta puede tardar hasta una hora en aparecer en todos los recursos asociados a un clúster determinado. Además, las etiquetas se propagan solo a las instancias de Compute Engine y a los discos persistentes que están conectados a instancias de Compute Engine. Otros recursos, como las cargas de trabajo, las reglas de reenvío, las direcciones IP y los discos persistentes no conectados no se etiquetan.

En clústeres de Standard, cuando se aplican etiquetas de clúster y de grupo de nodos a los recursos de Compute Engine, puedes cambiar las etiquetas de recurso de forma manual sin que GKE concilie esos cambios. En los clústeres de Autopilot, no puedes modificar de forma manual las etiquetas de los recursos de Compute Engine, ya que GKE administra los nodos por ti. Sin embargo, recomendamos que administres estas etiquetas a través de GKE. GKE no quitará las etiquetas existentes en esos recursos de Compute Engine, a menos que entren en conflicto con las etiquetas aplicadas de manera automática.

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.

Obtén una huella digital de la etiqueta para solicitudes a la API

Puedes omitir este paso si usas la consola de Google Cloud o la CLI de gcloud.

Cuando actualizas o agregas etiquetas de clúster mediante la API de GKE, tienes que proporcionar la huella digital de la etiqueta del clúster más actual con tu solicitud para prevenir cualquier conflicto con otras solicitudes.

Si quieres obtener la huella digital de la etiqueta de clúster más actualizada, ejecuta una solicitud GET para el clúster adecuado. Por ejemplo:

GET https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster

El resultado es similar a este:

200 OK

{

 "name": "mycluster",
 "description": "production-cluster",
 "initialNodeCount": 3,
 ...
 "resourceLabels": {
    "environment": "production",
    ...
  },
  "labelFingerprint": "p1ty_9HoBk0="
}

En este resultado, la propiedad labelFingerprint es la huella digital de la etiqueta de clúster.

Crea un clúster con etiquetas

Puedes crear clústeres de Autopilot con etiquetas mediante gcloud CLI, la consola de Google Cloud o la API de GKE.

gcloud container clusters create-auto CLUSTER_NAME \
    --labels=KEY=VALUE

gcloud container clusters create CLUSTER_NAME \
    --labels=KEY=VALUE

Agrega o actualiza las etiquetas de los clústeres existentes

Puedes agregar o actualizar etiquetas para los clústeres existentes de Autopilot y Standard mediante la CLI de gcloud, la consola de Google Cloud o la API de GKE.

gcloud container clusters update CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --update-labels=KEY=VALUE

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": {
  "environment": "production",
  "an-existing-tag": ""
 },
 "labelFingerprint": "42WmSpB8rSM="
}

Quita las etiquetas de clúster

Puedes quitar etiquetas de los clústeres de Autopilot y Standard mediante la CLI de gcloud, la consola de Google Cloud o la API de GKE.

gcloud container clusters update CLUSTER_NAME \
    --remove-labels=KEYS

Request

POST https://container.googleapis.com/v1/projects/myproject/zones/us-central1-f/clusters/example-cluster/resourceLabels

{
 "resourceLabels": { },
 "labelFingerprint": "42WmSpB8rSM="
}

Crear un grupo de nodos de Standard con etiquetas

Puedes crear un grupo de nodos con etiquetas en un clúster Standard mediante gcloud CLI, la consola de Google Cloud o la API de GKE.

gcloud container node-pools create NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --labels=KEY=VALUE

Agrega o actualiza las etiquetas de un grupo de nodos existente

Puedes agregar o actualizar etiquetas para los grupos de nodos existentes con gcloud CLI, la consola de Google Cloud o la API de GKE.

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --labels=KEY=VALUE

Quita las etiquetas del grupo de nodos

Puedes quitar etiquetas de los grupos de nodos mediante gcloud CLI, la consola de Google Cloud o la API de GKE.

gcloud container node-pools update NODE_POOL_NAME \
    --cluster=CLUSTER_NAME \
    --region=COMPUTE_REGION \
    --labels=KEY=VALUE

¿Qué sigue?

Consulta la descripción de GKE