Repositorios de etiquetas

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

Si deseas agrupar repositorios y otros recursos en Google Cloud para la generación de informes, las auditorías y el control de acceso en tu organización de Google Cloud, usa las etiquetas. Las etiquetas funcionan de forma independiente y puedes aplicarlas al mismo repositorio.

¿Qué son las etiquetas?

Una etiqueta es un par clave-valor que puedes asignar a los repositorios 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 reenvía al sistema de facturación, lo que te permite desglosar los cargos facturados por etiquetas. 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

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

  • Cada recurso puede tener hasta 64 etiquetas.
  • 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. Las claves deben comenzar con una letra en minúscula o un carácter internacional.
  • La porción de clave de una etiqueta 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

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.

  • Etiquetas de propiedad: Se usan para identificar los equipos responsables de las operaciones, por ejemplo: team:shopping-cart.

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.

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 la consola de Google Cloud.

    Abrir la página Repositorios

  2. Selecciona 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 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

Filtra repositorios por etiqueta

Puedes filtrar listas de repositorios por etiqueta en la consola de Google Cloud o mediante Google Cloud CLI.

Console

  1. Abre la página Repositorios en la consola de Google Cloud.

    Abrir la página Repositorios

  2. En el campo Filtro, selecciona Etiquetas como los criterios de filtro y, luego, ingresa tu clave, valor o par clave-valor.

    Por ejemplo, para mostrar solo los repositorios con la etiqueta env:dev, puedes ingresar cualquiera de las siguientes opciones:

    • Ingresa la clave: env
    • Ingresa el valor: dev
    • Ingresa el par clave-valor: env:dev

gcloud

Para filtrar según las etiquetas, usa la marca --filter con el comando gcloud artifacts repositorios list.

El valor de la marca --filter debe tener el formato labels.KEY=VALUE. Por ejemplo, si deseas filtrar los repositorios del proyecto activo en una etiqueta con env como clave y dev como valor, puedes ejecutar este comando:

gcloud artifacts repositories list --filter labels.env=dev

Para obtener más información sobre la sintaxis de filtro en la CLI de gcloud, consulta la documentación de gcloud topic filters.

Borra etiquetas

Para borrar etiquetas, haz lo siguiente:

Console

  1. Abre la página Repositorios en la consola de Google Cloud.

    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 quieres 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