Fluxos de trabalho de etiquetagem

As etiquetas são pares de chave/valor que pode usar para identificar e agrupar fluxos de trabalho relacionados e armazenar metadados sobre um fluxo de trabalho. Pode especificar várias etiquetas para um fluxo de trabalho.

Esta página explica como pode usar etiquetas com os seus fluxos de trabalho. Também descreve como adicionar, atualizar e remover as etiquetas de um fluxo de trabalho.

Para agrupar fluxos de trabalho e outros recursos em várias Google Cloud para relatórios, auditoria e controlo de acesso na sua Google Cloud organização, use etiquetas. As etiquetas e os rótulos funcionam independentemente uns dos outros e pode aplicá-los ambos ao mesmo fluxo de trabalho.

O que são etiquetas?

Uma etiqueta é um par de chave-valor que pode atribuir a Google Cloud fluxos de trabalho. Ajudam a organizar estes recursos e a gerir os custos em grande escala, com a granularidade de que precisa. Pode anexar uma etiqueta a cada recurso e, em seguida, filtrar os recursos com base nas respetivas etiquetas. As informações sobre as etiquetas são encaminhadas para o sistema de faturação que lhe permite discriminar os custos faturados por etiqueta. Com os relatórios de faturação integrados, pode filtrar e agrupar os custos por etiquetas de recursos. Também pode usar etiquetas para consultar exportações de dados de faturação.

Requisitos para etiquetas

As etiquetas aplicadas a um recurso têm de cumprir os seguintes requisitos:

  • Cada recurso pode ter até 64 etiquetas.
  • Cada etiqueta tem de ser um par chave-valor.
  • As chaves têm um comprimento mínimo de 1 caráter e um comprimento máximo de 63 carateres, e não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 carateres.
  • As chaves e os valores só podem conter letras minúsculas, carateres numéricos, sublinhados e travessões. Todos os carateres têm de usar a codificação UTF-8, e são permitidos carateres internacionais. As chaves têm de começar com uma letra minúscula ou um caráter internacional.
  • A parte da chave de uma etiqueta tem de ser exclusiva num único recurso. No entanto, pode usar a mesma chave com vários recursos.

Estes limites aplicam-se à chave e ao valor de cada etiqueta, bem como aos recursos Google Cloud individuais que têm etiquetas. Não existe um limite para o número de etiquetas que pode aplicar a todos os recursos num projeto.

Utilizações comuns das etiquetas

Seguem-se alguns exemplos de utilização comuns das etiquetas:

  • Etiquetas de equipa ou centro de custos: adicione etiquetas com base na equipa ou no centro de custos para distinguir fluxos de trabalho pertencentes a diferentes equipas (por exemplo, team:research e team:analytics). Pode usar este tipo de etiqueta para contabilidade de custos ou orçamentação.

  • Etiquetas de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Etiquetas de ambiente ou fase: por exemplo, environment:production e environment:test.

  • Etiquetas de estado: por exemplo, state:active,state:readytodelete e state:archive.

  • Etiquetas de propriedade: usadas para identificar as equipas responsáveis pelas operações, por exemplo: team:shopping-cart.

Não recomendamos a criação de um grande número de etiquetas únicas, como para carimbos de data/hora ou valores individuais para cada chamada da API. O problema desta abordagem é que, quando os valores mudam frequentemente ou com chaves que desorganizam o catálogo, torna-se difícil filtrar e gerar relatórios sobre os recursos de forma eficaz.

Etiquetas e marcadores

As etiquetas podem ser usadas como anotações consultáveis para recursos, mas não podem ser usadas para definir condições nas políticas. As etiquetas oferecem uma forma de permitir ou negar condicionalmente políticas com base no facto de um recurso ter uma etiqueta específica, oferecendo um controlo detalhado sobre as políticas. Para mais informações, consulte a Vista geral das etiquetas.

Adicione ou atualize etiquetas

Pode adicionar uma ou mais etiquetas a um fluxo de trabalho quando cria um fluxo de trabalho. Também pode adicionar ou editar etiquetas quando atualiza um fluxo de trabalho.

Se atualizar uma etiqueta existente ou adicionar uma nova, a nova etiqueta pode demorar até 10 minutos a entrar em vigor.

Filtre fluxos de trabalho por etiqueta

Pode pesquisar e listar fluxos de trabalho específicos filtrando-os por etiqueta.

Consola

  1. Na Google Cloud consola, aceda à página Fluxos de trabalho:

    Aceda a Fluxos de trabalho

  2. No campo Filtro, selecione Etiquetas como os critérios de filtro e, na lista Valores, selecione um par chave-valor.

gcloud

Use a flag --filter com o comando gcloud workflows list:

gcloud workflows list \
    --filter labels.KEY=VALUE

Substitua KEY e VALUE por um par de chave-valor de etiqueta.

Para mais informações sobre a sintaxe de filtros na CLI do Google Cloud, consulte gcloud topic filters.

As etiquetas do fluxo de trabalho são herdadas pelas execuções do fluxo de trabalho. Para ver as etiquetas de execução, use o método workflows.executions.list para listar e filtrar as execuções do fluxo de trabalho.

Eliminar etiquetas

Pode eliminar uma etiqueta específica através da Google Cloud consola ou usar a CLI gcloud para eliminar todas as etiquetas de um fluxo de trabalho.

Consola

  1. Na Google Cloud consola, aceda à página Fluxos de trabalho:

    Aceda a Fluxos de trabalho

  2. Clique no nome do fluxo de trabalho que quer atualizar.

    É apresentada a página Detalhes do fluxo de trabalho.

  3. Clique em Editar.

    É apresentada a página Editar fluxo de trabalho.

  4. Junto à etiqueta que quer remover, clique em Eliminar item.

  5. Clicar em Seguinte.

  6. Para voltar a implementar o fluxo de trabalho, clique em Implementar.

gcloud

Use o sinalizador --labels com um valor vazio e o comando gcloud workflows deploy:

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

Substitua o seguinte:

  • WORKFLOW_NAME: o nome do seu fluxo de trabalho.

  • YAML_OR_JSON_SOURCE_FILE: o ficheiro de origem do fluxo de trabalho no formato YAML ou JSON. Por exemplo: myFirstWorkflow.yaml.