Las etiquetas son pares clave-valor que puedes usar para identificar y agrupar flujos de trabajo relacionados, así como para 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 añadir, actualizar y quitar etiquetas de un flujo de trabajo.
Para agrupar flujos de trabajo y otros recursos en Google Cloud para generar informes, realizar auditorías y controlar el acceso en tu Google Cloud organización, usa etiquetas. Las etiquetas funcionan de forma independiente entre sí y puedes aplicar ambas al mismo flujo de trabajo.
¿Qué son las etiquetas?
Una etiqueta es un par clave-valor que puedes asignar a los Google Cloud flujos de trabajo. Te ayudan a organizar estos recursos y a gestionar tus costes a gran escala, con la granularidad que necesites. Puedes asignar una etiqueta a cada recurso y, después, filtrar los recursos en función de sus etiquetas. La información relacionada con las etiquetas se reenvía al sistema de facturación para que puedas desglosar los cargos facturados por etiquetas. Con los informes de facturación integrados, puedes filtrar y agrupar los costes por etiquetas de recursos. También puedes usar etiquetas para consultar exportaciones de datos de facturación.
Requisitos de las etiquetas
Las etiquetas aplicadas a un recurso deben cumplir los siguientes requisitos:
- Cada recurso puede tener hasta 64 etiquetas.
- Cada etiqueta debe ser un par clave-valor.
- Las claves deben tener como mínimo 1 carácter y como máximo 63 caracteres, y no pueden estar vacías. Los valores pueden estar vacíos y pueden tener hasta 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 codificación UTF-8, y se pueden usar caracteres internacionales. Las claves deben empezar por una letra minúscula o un carácter internacional.
- La parte de la clave de una etiqueta debe ser única en un solo recurso. Sin embargo, puedes usar la misma clave con varios recursos.
Estos límites se aplican a la clave y al valor de cada etiqueta, así como a los recursos individuales Google Cloud que tienen etiquetas. No hay límite en el número de etiquetas que puedes aplicar a todos los recursos de un proyecto.
Usos habituales de las etiquetas
A continuación se indican algunos de los usos más habituales de las etiquetas:
Etiquetas de equipo o centro de costes: añade etiquetas basadas en el equipo o el centro de costes para distinguir los flujos de trabajo propiedad de diferentes equipos (por ejemplo,
team:researchyteam:analytics). Puedes usar este tipo de etiqueta para la contabilidad de costes o la elaboración de presupuestos.Etiquetas de componentes: por ejemplo,
component:redis,component:frontend,component:ingestycomponent:dashboard.Etiquetas de entorno o fase: por ejemplo,
environment:productionyenvironment:test.Etiquetas de estado: por ejemplo,
state:active,state:readytodeleteystate:archive.Etiquetas de propiedad: se usan para identificar los equipos responsables de las operaciones. Por ejemplo,
team:shopping-cart.
No recomendamos crear un gran número de etiquetas únicas, como las de marcas de tiempo o valores individuales para cada llamada a la API. El problema de este enfoque es que, cuando los valores cambian con frecuencia o con claves que saturan el catálogo, resulta difícil filtrar y generar informes sobre los recursos de forma eficaz.
Etiquetas
Las etiquetas se pueden usar como anotaciones consultables para los recursos, pero no se pueden usar para definir condiciones en las políticas. Las etiquetas permiten aplicar o denegar políticas de forma condicional en función de si un recurso tiene una etiqueta específica, lo que proporciona un control pormenorizado de las políticas. Para obtener más información, consulta la descripción general de las etiquetas.
Añadir o actualizar etiquetas
Puedes añadir una o más etiquetas a un flujo de trabajo cuando lo creas. También puedes añadir o editar etiquetas cuando actualices un flujo de trabajo.
Si actualizas una etiqueta o añades una nueva, puede tardar hasta 10 minutos en aplicarse.
Filtrar flujos de trabajo por etiqueta
Puedes buscar y enumerar flujos de trabajo específicos filtrándolos por etiqueta.
Consola
En la Google Cloud consola, ve a la página Flujos de trabajo:
En el campo Filtrar, 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
Sustituye KEY y VALUE por un par clave-valor de etiqueta.
Para obtener más información sobre la sintaxis de los filtros en la CLI de Google Cloud, 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 listar y filtrar las ejecuciones de flujos de trabajo.
Eliminar etiquetas
Puedes eliminar una etiqueta específica mediante la Google Cloud consola o usar la CLI de gcloud para eliminar todas las etiquetas de un flujo de trabajo.
Consola
En la Google Cloud consola, ve a la página Flujos de trabajo:
Haz clic en el nombre del flujo de trabajo que quieras actualizar.
Se mostrará 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 quieras quitar, haz clic en Eliminar 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
Haz los cambios siguientes:
WORKFLOW_NAME: el nombre del flujo de trabajo.YAML_OR_JSON_SOURCE_FILE: el archivo de origen del flujo de trabajo en formato YAML o JSON. Por ejemplo:myFirstWorkflow.yaml.