Fluxos de trabalho de rótulos

Os rótulos são pares de chave-valor que você pode usar para identificar e agrupar fluxos de trabalho relacionados e armazenar metadados sobre um fluxo de trabalho. É possível especificar vários rótulos para um fluxo de trabalho.

Nesta página, explicamos como usar rótulos com seus fluxos de trabalho. Nela também descrevemos como adicionar, atualizar e remover os rótulos de um fluxo de trabalho.

Para agrupar fluxos de trabalho e outros recursos em Google Cloud relatórios, auditorias e controle de acesso na Google Cloud organização, use tags. As tags e os rótulos funcionam independentemente uns dos outros e podem ser aplicados ao mesmo fluxo de trabalho.

O que são rótulos?

Um rótulo é um par de chave-valor que pode ser atribuído a fluxos de trabalho Google Cloud . Eles ajudam a organizar esses recursos e gerenciar seus custos em escala, com a granularidade necessária. É possível anexar um rótulo a cada recurso e filtrar os recursos com base nesses rótulos. As informações sobre rótulos são encaminhadas ao sistema de faturamento, que permite detalhar as cobranças faturadas por rótulo. Com os relatórios de faturamento integrados, é possível filtrar e agrupar custos por rótulos de recursos. Também é possível usar rótulos para consultar as exportações de dados de faturamento.

Requisitos para rótulos

Os rótulos aplicados a um recurso precisam atender aos seguintes requisitos:

  • Cada recurso pode ter até 64 rótulos.
  • Cada rótulo precisa ser um par de chave-valor.
  • As chaves têm comprimento mínimo de 1 e máximo de 63 caracteres. Além disso, elas não podem estar vazias. Os valores podem estar vazios e ter um comprimento máximo de 63 caracteres.
  • As chaves e os valores contêm apenas letras minúsculas, caracteres numéricos, sublinhados e traços. Todos os caracteres precisam usar a codificação UTF-8, e os caracteres internacionais são permitidos. As chaves precisam começar com uma letra minúscula ou um caractere internacional.
  • A parte principal de um rótulo de cluster precisa ser exclusiva em um único recurso. No entanto, é possível usar a mesma chave com vários recursos.

Esses limites se aplicam à chave e ao valor de cada rótulo e aos recursos individuais do Google Cloud que têm rótulos. Não há limite para a quantidade de rótulos que podem ser aplicados a todos os recursos em um projeto.

Usos comuns dos rótulos

Veja alguns casos de uso comum para rótulos:

  • Rótulos de centro de custo ou de equipe: adicione rótulos com base na equipe ou no centro de custo para distinguir fluxos de trabalho pertencentes a equipes diferentes (por exemplo, team:research e team:analytics). É possível usar esse tipo de rótulo para contabilidade de custos ou orçamento.

  • Rótulos de componentes: por exemplo, component:redis, component:frontend, component:ingest e component:dashboard.

  • Rótulos de ambientes ou de estágios: por exemplo, environment:production e environment:test.

  • Rótulos de estado: por exemplo, state:active, state:readytodelete e state:archive.

  • Rótulos de propriedade: usados para identificar as equipes responsáveis pelas operações, por exemplo: team:shopping-cart.

Não recomendamos a criação de um grande número de rótulos exclusivos, como os relacionados a carimbos de data/hora ou valores individuais, para todas as chamadas de API. O problema com essa abordagem é que, quando os valores mudam com frequência ou com chaves que desordenam o catálogo, isso dificulta a filtragem e a geração de relatórios sobre os recursos.

Rótulos e tags

Os rótulos podem ser usados como anotações de consulta para recursos, mas não podem ser usados para definir condições em políticas. Com as tags, é possível permitir ou negar políticas condicionalmente com base em um recurso ter ou não uma tag específica, fornecendo controle refinado sobre as políticas. Para mais informações, consulte a Visão geral das tags.

Adicionar ou atualizar rótulos

É possível adicionar um ou mais rótulos a um fluxo de trabalho ao criar um fluxo de trabalho. Também é possível adicionar ou editar rótulos ao atualizar um fluxo de trabalho.

Se você atualizar um rótulo atual ou adicionar um novo, pode levar até 10 minutos para que o novo rótulo entre em vigor.

Filtrar fluxos de trabalho por rótulo

Você pode pesquisar e listar fluxos de trabalho específicos filtrando por rótulo.

Console

  1. No console do Google Cloud, acesse a página Fluxos de trabalho.

    Acessar fluxos de trabalho

  2. No campo Filtro, selecione Rótulos como os critérios de filtro e, na lista Valores, selecione um par de 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 rótulo.

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

Os rótulos do fluxo de trabalho são herdados pelas execuções do fluxo de trabalho. Para conferir os rótulos de execução, use o método workflows.executions.list para listar e filtrar execuções de fluxo de trabalho.

Excluir marcadores

É possível excluir um identificador específico usando o console do Google Cloud ou a CLI gcloud para excluir todos os identificadores de um fluxo de trabalho.

Console

  1. No console do Google Cloud, acesse a página Fluxos de trabalho.

    Acessar fluxos de trabalho

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

    A página Detalhes do fluxo de trabalho é exibida.

  3. Clique em Editar.

    A página Editar fluxo de trabalho é exibida.

  4. Ao lado do rótulo que você quer remover, clique em Excluir item.

  5. Clique em Próxima.

  6. Para reimplantar o fluxo de trabalho, clique em Implantar.

gcloud

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

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

Substitua:

  • WORKFLOW_NAME: o nome do fluxo de trabalho.

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