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:

Desenvolvedor do Cloud Run (roles/run.developer) no job do Cloud Run
Usuário da conta de serviço (roles/iam.serviceAccountUser) na conta de serviço

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 identificador em um job do Cloud Run.

Linha de comando

Para definir um identificador 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;

Para definir um rótulo em um job atual:

gcloud run jobs update JOB_NAME --labels KEY=VALUE

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

Faça o download e consulte a configuração do job que já existe usando o comando gcloud run jobs describe --format export, que gera resultados limpos no formato YAML. Em seguida, modifique os campos descritos abaixo e faça upload do YAML modificado usando o comando gcloud run jobs replace. Modifique os campos somente conforme documentado.

Para ver e fazer o download da configuração:

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

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.
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