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

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

  • Etiquetas de clúster por equipo o centro de costo: agrega etiquetas por equipo o centro de costo a fin de distinguir los clústeres que son propiedad de equipos diferentes (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 de 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 debe ser de 63 caracteres.
  • Las claves y los valores solo pueden contener letras minúsculas, 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 que habilitaste 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 las etiquetas de un clúster con Google Cloud Platform Console, con 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 de 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 al momento de crear 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 GCP Console, sigue estos pasos:

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

    Ir al menú de 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 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

Si el clúster tiene etiquetas existentes que quieres conservar, debes incluirlas junto con las nuevas que quieras agregar.

Console

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

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

    Ir al menú de 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 actualizada y una lista completa de las etiquetas que se tienen que aplicar.

Al igual que con los metadatos y las etiquetas, 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

Con la herramienta de línea de comandos de gcloud, ejecuta 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 quieres quitar una etiqueta con GCP Console, sigue los pasos siguientes:

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

    Ir al menú de 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 la 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 la X que aparece junto a las etiquetas que deseas quitar.
    4. Haz clic en Guardar.

API

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

Request

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

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

Pasos siguientes

Lee la descripción general de GKE.

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

Enviar comentarios sobre...