Crea y administra etiquetas

En esta página, se proporciona una descripción general de etiquetas de clúster en GKE.

¿Qué son las etiquetas de clúster?

Una etiqueta de clúster es un par clave-valor que te ayuda a organizar los clústeres de Google Cloud. 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 a fin de que puedas desglosar tus cargos de facturación según las etiquetas.

Usos comunes de las etiquetas de clúster

No recomendamos crear grandes cantidades de etiquetas únicas, como marcas de tiempo o valores individuales para cada llamada a la API. 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.

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 varias etiquetas de clúster, con un máximo de 64.
  • 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 y, además, se permiten los caracteres internacionales.
  • La porción de clave de una etiqueta de clúster debe ser única. Sin embargo, puedes usar la misma clave en varios recursos.
  • Las claves deben comenzar con una letra en minúscula o un carácter internacional.

Antes de comenzar

Sigue estos pasos a fin de prepararte para esta tarea:

  • Asegúrate de haber habilitado la API de Google Kubernetes Engine.
  • Habilitar la API de Google Kubernetes Engine
  • Asegúrate de que instalaste el SDK de Cloud.
  • Establece tu ID del proyecto predeterminado:
    gcloud config set project [PROJECT_ID]
  • Si trabajas con clústeres zonales, establece tu zona de procesamiento predeterminada:
    gcloud config set compute/zone [COMPUTE_ZONE]
  • Si trabajas con clústeres regionales, establece tu región de procesamiento predeterminada:
    gcloud config set compute/region [COMPUTE_REGION]
  • Actualiza gcloud a la versión más reciente:
    gcloud components update

Acerca de la etiquetación de clústeres

En GKE, debes aplicar etiquetas en el nivel del clúster. Cuando etiquetas un clúster, la etiqueta elegida se propaga hacia todos los recursos individuales del clúster (como nodos y discos persistentes).

Puedes agregar, actualizar y quitar etiquetas de clúster con Google Cloud Console, la herramienta de línea de comandos de gcloud o la API de GKE.

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

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

En la respuesta, busca la propiedad labelFingerprint:

200 OK

{

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

Crea un clúster con etiquetas

gcloud

Para agregar etiquetas cuando creas tu clúster con la herramienta de gcloud, ejecuta el comando siguiente:

gcloud container clusters create [CLUSTER_NAME] --labels [KEY]=[VALUE]

Por ejemplo:

gcloud container clusters create example-cluster --labels env=dev

Console

Para agregar etiquetas al momento de crear tu clúster con Cloud Console, sigue estos pasos:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Haz clic en Crear clúster.

  3. Configura tu clúster como desees. Luego, haz clic en Opciones avanzadas.

  4. Haz clic en Agregar etiqueta.

  5. Agrega las etiquetas como desees.

  6. Haz clic en Crear.

API

Para incluir una etiqueta al momento de crear tu clúster, especifica el objeto resourceLabels dentro del objeto cluster que proporcionas a projects.zones.clusters.create.

Agrega o actualiza las etiquetas de los clústeres existentes

gcloud

Para actualizar las etiquetas con la herramienta de gcloud, ejecuta el comando siguiente:

gcloud container clusters update [CLUSTER_NAME] --update-labels [KEY]=[VALUE]

Por ejemplo:

gcloud container clusters update example-cluster --update-labels env=dev,release=stable

La actualización de la etiqueta reemplazará cualquier etiqueta preexistente. Si el clúster tiene etiquetas existentes que deseas conservar, debes incluirlas junto con las nuevas que quieras agregar.

Console

Para agregar o actualizar etiquetas con Cloud Console, sigue estos pasos:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Para agregar etiquetas a un solo clúster, haz clic en el botón Editar, que tiene forma de lápiz.

    1. Haz clic en Agregar etiquetas y agrega una o más etiquetas.
    2. Haz clic en Guardar.
  3. Si quieres agregar etiquetas a varios clústeres de una sola vez, sigue estos pasos:

    1. Selecciona la casilla de verificación de los clústeres que deseas etiquetar.
    2. Haz clic en Mostrar panel de información para expandir la columna de etiquetas si no está visible.
    3. Actualiza o agrega etiquetas nuevas como desees.
    4. Haz clic en Guardar.

API

Para actualizar etiquetas, realiza una solicitud POST al método resourceLabels del clúster con la huella digital más reciente y una lista completa de las etiquetas que se tienen que aplicar.

Al igual que con los metadatos y los rótulos identificadores, si el clúster tiene etiquetas existentes que deseas conservar, debes incluirlas en la solicitud junto con las nuevas que quieres agregar.

Por ejemplo, en el fragmento siguiente, se realiza una solicitud al método resourceLabels:

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

{
 "resourceLabels": {
  "env": "test",
  "an-existing-tag": ""
 },
 "labelFingerprint": "42WmSpB8rSM="
}

Quita las etiquetas de clúster

gcloud

Usa la herramienta de línea de comandos de gcloud para ejecutar el comando update con la marca --remove-labels. Proporciona un conjunto de claves de etiquetas para quitar. Por ejemplo:

gcloud container clusters update example-cluster --remove-labels env

Console

Si deseas quitar una etiqueta con Cloud Console, sigue los pasos siguientes:

  1. Dirígete al menú de Google Kubernetes Engine en Cloud Console.

    Ir al menú Google Kubernetes Engine

  2. Para quitar etiquetas de un solo clúster, haz clic en el botón Editar, que tiene forma de lápiz.

    1. Haz clic en X junto a cualquier etiqueta para quitarla.
    2. Haz clic en Guardar.
  3. Para quitar etiquetas de varios clústeres de una vez:

    1. Selecciona las casillas de verificación que aparecen junto a los clústeres cuyas etiquetas deseas quitar.
    2. Haz clic en Mostrar panel de información para expandir la columna de etiquetas si no está visible.
    3. Haz clic en X junto a todas las etiquetas que deseas quitar.
    4. Haz clic en Guardar.

API

En la API, realiza una solicitud POST al método resourceLabels para el clúster correspondiente. Proporciona el labelsFingerprint actual y una lista de etiquetas vacía para quitar todas las etiquetas, o proporciona una lista de las etiquetas que deseas conservar (omite las etiquetas que deseas quitar). Por ejemplo:

Request

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

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

Próximos pasos

Consulta la descripción general de GKE.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Kubernetes Engine