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 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 Google Cloud válidos 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 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 a Google Cloud CLI, o YAML ou o Terraform 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

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

    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.

  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.

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