Crea y administra etiquetas

Usa etiquetas para identificar y agrupar repositorios relacionados. Puedes especificar varias etiquetas para un repositorio.

¿Qué son las etiquetas?

Una etiqueta es un par clave-valor que te ayuda a organizar los repositorios 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

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:

  • Etiquetas por equipo o centro de costos: Agrega etiquetas por equipo o centro de costos para distinguir los repositorios pertenecientes 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 componentes: por ejemplo, component:redis, component:frontend, component:ingest y component:dashboard.

  • Etiquetas de entorno o etapa: por ejemplo, environment:production y environment:test.

  • Etiquetas de estado: por ejemplo, state:active, state:readytodelete y state:archive.

Requisitos para las etiquetas

Las etiquetas que se aplican a un recurso deben cumplir los siguientes requisitos:

  • Cada recurso puede tener varias etiquetas, hasta 64.
  • Cada etiqueta 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.
  • La porción de clave de una etiqueta 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.

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

Agrega y actualiza las etiquetas

Puedes agregar una o más etiquetas a un repositorio. También puedes editar el valor de una etiqueta existente.

Para etiquetar un repositorio, haz lo siguiente:

Console

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página Repositorios

  2. Haz clic en Seleccionar un repositorio.

  3. Si el panel de información junto a la lista de repositorios no está abierto, haz clic en Mostrar panel de información.

  4. En el panel de información, haz clic en la pestaña Etiquetas.

  5. Agrega o edita etiquetas:

    1. Para agregar una etiqueta, haz clic en Agregar etiqueta. Especifica el par clave-valor para la etiqueta y, luego, haz clic en Guardar.
    2. Para editar una etiqueta existente, cambia el valor de la etiqueta y, luego, haz clic en Guardar.

gcloud

Puedes especificar una o más etiquetas que desees agregar o editar.

  • Si existe una etiqueta, se actualiza el valor correspondiente.
  • Si no existe una etiqueta, se crea una.
  • Si en el comando, también se incluye la marca --clear-labels, todas las etiquetas existentes se quitan antes de agregar etiquetas nuevas.

Ejecuta el siguiente comando:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --update-labels="KEY=VALUE,..."

Donde

  • REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • PROJECT es el ID del proyecto de Google Cloud. Si se omite esta marca, se usa el proyecto actual o predeterminado.
  • LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usarla.
  • KEY=VALUE,... es una lista de etiquetas separadas por comas que se especifican como pares clave-valor. Por ejemplo: team=team-1,product=example_product,stage=development

Para obtener más información sobre el comando, ejecuta el siguiente comando:

gcloud artifacts repositories update --help

Borra etiquetas

Para borrar etiquetas, haz lo siguiente:

Console

  1. Abre la página Repositorios en Cloud Console.

    Abrir la página Repositorios

  2. Haz clic en Seleccionar un repositorio.

  3. Si el panel de información junto a la lista de repositorios no está abierto, haz clic en Mostrar panel de información.

  4. En el panel de información, haz clic en la pestaña Etiquetas.

  5. Haz clic en Borrar elemento junto a la etiqueta que deseas quitar.

gcloud

Puedes borrar etiquetas específicas o quitar todas las etiquetas de un repositorio.

Para quitar etiquetas específicas, ejecuta el siguiente comando:

gcloud artifacts repositories update REPOSITORY [--project=PROJECT] \
[--location=LOCATION] --remove-labels="LABEL,..."

Para quitar todas las etiquetas, ejecuta el siguiente comando:

gcloud artifacts repositories update REPOSITORY \
[--project=PROJECT] [--location=LOCATION] --clear-labels

Donde

  • REPOSITORY es el nombre del repositorio. Si configuraste un repositorio predeterminado, puedes omitir esta marca para usarlo.
  • PROJECT es el ID del proyecto de Google Cloud. Si se omite esta marca, se usa el proyecto actual o predeterminado.
  • LOCATION es una ubicación regional o multirregional. Usa esta marca para ver los repositorios en una ubicación específica. Si configuraste una ubicación predeterminada, puedes omitir esta marca para usarla.
  • LABEL,... es una lista de etiquetas separadas por comas, que son las claves de cada par KEY=VALUE. Por ejemplo: team,product.

Para obtener más información sobre el comando, ejecuta el siguiente comando:

   gcloud artifacts repositories update --help