Las etiquetas son pares clave-valor que puedes usar para identificar y agrupar flujos de trabajo relacionados, y almacenar metadatos sobre un flujo de trabajo. Puedes especificar varias etiquetas para un flujo de trabajo.
En esta página, se explica cómo puedes usar etiquetas con tus flujos de trabajo. También se describe cómo agregar, actualizar y quitar las etiquetas de un flujo de trabajo.
Para agrupar flujos de trabajo y otros recursos en Google Cloud para informes, auditorías y control de acceso en tu Google Cloud organización, usa etiquetas. Las etiquetas funcionan de manera independiente unas de otras y puedes aplicarlas al mismo flujo de trabajo.
¿Qué son las etiquetas de recurso?
Una etiqueta es un par clave-valor que puedes asignar a los Google Cloud flujos de trabajo. 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 envía al sistema de facturación que te permite desglosar los cargos facturados por etiqueta. 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 de clúster.
- 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, y a los recursos Google Cloud individuales que tienen etiquetas. 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 flujos de trabajo que pertenecen a distintos equipos (por ejemplo,
team:researchyteam:analytics). Puedes usar este tipo de etiqueta para la contabilidad de costos o la creación de presupuestos.Etiquetas de componentes: por ejemplo,
component:redis,component:frontend,component:ingestycomponent:dashboard.Etiquetas de entorno o etapa: por ejemplo,
environment:productionyenvironment:test.Etiquetas de estado: por ejemplo,
state:active,state:readytodeleteystate:archive.Etiquetas de propiedad: Se usan para identificar a 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 o actualiza etiquetas
Puedes agregar una o más etiquetas a un flujo de trabajo cuando lo creas. También puedes agregar o editar etiquetas cuando actualizas un flujo de trabajo.
Si actualizas una etiqueta existente o agregas una nueva, esta puede tardar hasta 10 minutos en aplicarse.
Cómo filtrar flujos de trabajo por etiqueta
Puedes buscar y mostrar flujos de trabajo específicos filtrándolos por etiqueta.
Console
En la consola de Google Cloud, ve a la página Workflows.
En el campo Filtro, selecciona Etiquetas como criterio de filtro y, en la lista Valores, selecciona un par clave-valor.
gcloud
Usa la marca --filter con el comando gcloud workflows list:
gcloud workflows list \
--filter labels.KEY=VALUE
Reemplaza KEY y VALUE por un par clave-valor de etiqueta.
Para obtener más información sobre la sintaxis de filtro en Google Cloud CLI, consulta gcloud topic filters.
Las ejecuciones del flujo de trabajo heredan las etiquetas del flujo de trabajo. Para ver las etiquetas de ejecución, usa el método workflows.executions.list para enumerar y filtrar las ejecuciones de flujos de trabajo.
Borrar etiquetas
Puedes borrar una etiqueta específica con la consola de Google Cloud o usar la CLI de gcloud para borrar todas las etiquetas de un flujo de trabajo.
Console
En la consola de Google Cloud, ve a la página Workflows.
Haz clic en el nombre del flujo de trabajo que deseas actualizar.
Aparecerá la página Detalles del flujo de trabajo.
Haz clic en Editar.
Aparecerá la página Editar flujo de trabajo.
Junto a la etiqueta que quieres quitar, haz clic en Borrar elemento.
Haz clic en Siguiente.
Para volver a implementar el flujo de trabajo, haz clic en Implementar.
gcloud
Usa la marca --labels con un valor vacío y el comando gcloud workflows deploy:
gcloud workflows deploy WORKFLOW_NAME \ --labels="" \ --source=YAML_OR_JSON_SOURCE_FILE
Reemplaza lo siguiente:
WORKFLOW_NAME: El nombre de tu flujo de trabajo.YAML_OR_JSON_SOURCE_FILE: Es el archivo fuente del flujo de trabajo en formato YAML o JSON. Por ejemplo:myFirstWorkflow.yaml.