Configurar rótulos para instâncias

Os rótulos do Cloud Run são pares de chave-valor aplicados a instâncias do Cloud Run. Esta página mostra como definir, modificar e excluir rótulos nas instâncias do Cloud Run. Quando você define um rótulo em uma instância do Cloud Run, uma nova revisão com esse rótulo é criada para essa instância. O rótulo não é aplicado a revisões mais antigas.

Os possíveis usos incluem:

  • Alocação de custos e detalhamentos de faturamento.
  • Identificar recursos usados por equipes ou centros de custo individuais.
  • Diferenciar ambientes de implantação (produção, preparo, controle de qualidade ou teste).
  • Identificar proprietários e rótulos de estado.
  • Filtrar registros no Logging.

Regras de uso de rótulos

A regra a seguir se aplica ao uso de rótulos definidos em uma instância do Cloud Run:

Somente rótulos Google Cloud válidos podem ser usados no Cloud Run.

Rótulos para dados de faturamento e geração de registros

O Cloud Billing e o Cloud Logging só recebem rótulos especificados em no atributo spec.template.metadata.labels em YAML ou em template em Terraform. Se você configurar rótulos usando a Google Cloud CLI, o Cloud Run vai adicionar os rótulos aos atributos metadata.labels e spec.template.metadata.labels.

Funções exigidas

Para receber as permissões necessárias para configurar e implantar instâncias do Cloud Run, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se a instância do Cloud Run interage com Google Cloud APIs, como as bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Definir ou modificar marcadores

É possível definir ou modificar rótulos usando a Google Cloud CLI:

gcloud

É possível atualizar rótulos de uma instância usando o comando:

gcloud beta run instances update INSTANCE --update-labels KEY=VALUE

Para atualizar mais de um rótulo, forneça uma lista delimitada por vírgulas de pares de chave-valor. O comando update-labels define um novo valor para a chave do rótulo se ele já existir. Caso contrário, ele cria um novo rótulo.

Substitua:

  • INSTANCE: o nome da instância do Cloud Run.
  • KEY: o nome da chave do rótulo.
  • VALUE: o valor da chave.

Também é possível definir rótulos durante a implantação:

gcloud beta run instances deploy INSTANCE --image IMAGE --labels KEY=VALUE

Para criar mais de um rótulo durante a implantação, forneça uma lista de pares chave-valor delimitada por vírgulas.

YAML

  1. Se você estiver criando uma nova instância, pule esta etapa. Se você estiver atualizando uma instância existente, baixe a configuração YAML correspondente:

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. O exemplo a seguir contém a configuração YAML:

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    Substitua:

    • INSTANCE: o nome da instância do Cloud Run.
    • KEY e VALUE: os pares de chave-valor para rótulos.

    metadata.labels define os identificadores no objeto de instância, enquanto spec.template.metadata.labels define os identificadores na revisão criada. O Cloud Run só propaga rótulos definidos na revisão para o Cloud Billing e o Cloud Logging.

  3. Crie ou atualize a instância usando o comando a seguir:

    gcloud beta run instances replace instance.yaml

Listar instâncias por rótulo

É possível listar instâncias por rótulo usando um filtro da Google Cloud CLI:

  gcloud beta run instances list --filter metadata.labels.LABEL=VALUE

Substitua:

  • LABEL: o nome do rótulo.
  • VALUE: o valor a ser incluído na lista filtrada.

Excluir um rótulo em uma instância

É possível usar a Google Cloud CLI para excluir rótulos em uma instância.

gcloud

Para limpar todos os rótulos de uma instância:

gcloud beta run instances update INSTANCE --clear-labels

Para excluir rótulos específicos de uma instância, forneça uma lista de chaves delimitada por vírgulas:

gcloud beta run instances update INSTANCE --remove-labels LABEL

Substitua:

  • INSTANCE: o nome da instância do Cloud Run.
  • LABEL: o nome do rótulo.