Configurar rótulos para jobs

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:

  • 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 um job 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 no atributo spec.template.metadata.labels em YAML ou em template no Terraform. Se você configurar rótulos usando o consoleGoogle Cloud ou 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 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 doGoogle Cloud , 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 usar o Google Cloud console, a Google Cloud CLI, o YAML ou o Terraform para definir um rótulo em um job do Cloud Run.

Console

  1. No console Google Cloud , acesse a página Jobs do Cloud Run:

    Acessar o Cloud Run

  2. Marque a caixa de seleção à esquerda do job em que você está definindo o marcador.

  3. Verifique se o Painel de informações no canto direito está ativado (Mostrar painel de informações).

  4. Clique em Rótulos para exibir o painel de rótulos.

    Definir rótulo

  5. Para editar um valor de chave do rótulo atual, localize o rótulo e mude o Valor.

  6. Para definir um novo rótulo no serviço, clique em Adicionar rótulo e forneça a chave e o valor.

  7. Clique em Salvar.

gcloud

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

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

    Substitua:

    • JOB_NAME pelo nome do job.
    • KEY pelo nome da chave do rótulo.
    • VALUE com o valor da chave.
    • IMAGE_URL: uma referência à imagem do 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

    Substitua:

    • LABEL com o nome do rótulo.
    • VALUE com o valor escolhido.

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

    O Cloud Run só propaga os rótulos definidos no atributo spec.template.metadata.labels para o Cloud Billing e o Cloud Logging.

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

    gcloud run jobs replace job.yaml

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

Adicione o seguinte a um recurso google_cloud_run_v2_job na configuração do Terraform:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

Substitua:

  • JOB_NAME: o nome do seu job do Cloud Run;
  • REGION: a Google Cloud região. Por exemplo, europe-west1.
  • LABEL: o nome do rótulo.
  • VALUE: o valor escolhido.

O Cloud Run só propaga os rótulos definidos em template para o Cloud Billing e o Cloud Logging.

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: o nome do rótulo
  • VALUE: o 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

Substitua:

  • JOB: o nome do seu job do Cloud Run
  • LABEL: o nome do seu rótulo