Configurar marcadores

Os rótulos do Cloud Run são pares de chave-valor aplicados a jobs do Cloud Run. Nesta página, mostramos como definir, modificar e excluir rótulos dos jobs do Cloud Run.

Os possíveis usos incluem:

  • Usar para 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 os proprietários e os 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 um job do Cloud Run:

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

Funções exigidas

Para receber as permissões necessárias para configurar os jobs 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 o job do Cloud Run interagir com APIs do Google Cloud, como 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 usar a CLI do Google Cloud ou o YAML para definir um rótulo em um job do Cloud Run.

gcloud

  1. Para definir um rótulo em um novo job:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    Substituir

    • JOB_NAME pelo nome do job;
    • KEY pelo nome da chave do rótulo;
    • VALUE pelo valor da chave.
    • IMAGE_URL por uma referência à imagem de contêiner, por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest;

  2. Para definir um rótulo em um job atual:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE

  3. Para atualizar mais de um rótulo, forneça uma lista delimitada por vírgulas de pares de chave-valor.

    gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2

YAML

  1. Se você estiver criando um novo serviço, pule esta etapa. Se você estiver atualizando um serviço existente, faça o download da configuração YAML correspondente:

    gcloud run jobs describe JOB_NAME --format export > job.yaml

  2. Atualize os atributos labels em dois lugares:

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE

    Substituir

    • LABEL pelo nome do rótulo;
    • VALUE pelo valor desejado.

    Também é possível definir outras configurações, como variáveis de ambiente ou limites de memória.

  3. Atualize a configuração do job que já existe:

    gcloud run jobs replace job.yaml

Listar jobs por rótulo

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

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE

Substitua:

  • LABEL pelo nome do rótulo;
  • VALUE pelo valor a ser incluído na lista filtrada

Excluir um identificador de um job

Para limpar todos os identificadores de um serviço:

gcloud run jobs update JOB --clear-labels

Para excluir identificador específicos de um serviço, forneça uma lista de chaves delimitada por vírgulas: 

gcloud run jobs update JOB --remove-labels LABEL

Substituir

  • JOB pelo nome do job do Cloud Run.
  • LABEL pelo nome do rótulo