Crea y administra etiquetas

beta

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 reenví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 siguientes requisitos:

  • 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.
  • Las claves deben tener 1 carácter como mínimo y 63 caracteres como máximo, 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 solo pueden contener letras en minúscula, caracteres numéricos, guiones bajos y guiones. Todos los caracteres deben usar la codificación UTF-8 y, también, 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

Antes de comenzar, asegúrate de haber realizado las siguientes tareas:

Establece la configuración de gcloud predeterminada mediante uno de los siguientes métodos:

  • Usa gcloud init si quieres ver una introducción sobre cómo configurar parámetros predeterminados.
  • Usa gcloud config para establecer el ID, la zona y la región del proyecto de manera individual.

Usa gcloud init

  1. Ejecuta gcloud init y sigue las instrucciones:

    gcloud init

    Si usas SSH en un servidor remoto, usa la marca --console-only para evitar que el comando inicie un navegador:

    gcloud init --console-only
  2. Sigue las instrucciones a fin de autorizar a gcloud para que use tu cuenta de Google Cloud.
  3. Crea una configuración nueva o selecciona una existente.
  4. Elige un proyecto de Google Cloud.
  5. Elige una zona predeterminada de Compute Engine.

Usa la configuración de gcloud

  • 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 a la API

Cuando actualizas o agregas etiquetas de clúster mediante la API de GKE, debes 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. Visita el 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. Visita el 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. Visita el 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, haz lo siguiente:

    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.