Configure etiquetas para empregos

As etiquetas do Cloud Run são pares de chave-valor aplicados a tarefas do Cloud Run. Esta página mostra como definir, modificar e eliminar etiquetas nos seus trabalhos do Cloud Run.

As possíveis utilizações incluem:

  • Atribuição de custos e discriminações de faturação.
  • Identificar os recursos usados por equipas individuais ou centros de custos.
  • Distinguir ambientes de implementação (produção, preparação, controlo de qualidade ou teste).
  • Identificar proprietários e etiquetas de estado.
  • Filtre registos no Logging.

Regras de utilização das etiquetas

A seguinte regra aplica-se à utilização de etiquetas definidas num trabalho do Cloud Run:

Só podem ser usadas etiquetas Google Cloud válidas no Cloud Run.

Funções necessárias

Para receber as autorizações de que precisa para configurar tarefas do Cloud Run, peça ao seu administrador para lhe conceder as seguintes funções de IAM:

Para ver uma lista de funções e autorizações de IAM associadas ao Cloud Run, consulte os artigos Funções de IAM do Cloud Run e Autorizações de IAM do Cloud Run. Se a sua tarefa do Cloud Run interagir com Google Cloud APIs, como as bibliotecas de cliente da Google Cloud, consulte o guia de configuração da identidade do serviço. Para mais informações sobre a atribuição de funções, consulte as autorizações de implementação e faça a gestão do acesso.

Defina ou modifique etiquetas

Pode usar a CLI Google Cloud, o YAML ou o Terraform para definir uma etiqueta numa tarefa do Cloud Run.

gcloud

  1. Para definir uma etiqueta numa nova tarefa:

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

    Substitua o seguinte:

    • JOB_NAME com o nome do seu trabalho.
    • KEY com o nome da chave da etiqueta.
    • VALUE com o valor da chave.
    • IMAGE_URL: uma referência à imagem do contentor, por exemplo, us-docker.pkg.dev/cloudrun/container/job:latest.

  2. Para definir uma etiqueta num trabalho existente:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE

  3. Para criar mais do que uma etiqueta, forneça uma lista de pares de chave/valor delimitada por vírgulas.

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

YAML

  1. Se estiver a criar uma nova tarefa, ignore este passo. Se estiver a atualizar uma tarefa existente, transfira a respetiva configuração YAML:

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

  2. Atualize os atributos labels em dois locais:

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

    Substitua o seguinte:

    • LABEL com o nome da etiqueta.
    • VALUE com o valor escolhido.

    Também pode especificar mais configurações, como variáveis de ambiente ou limites de memória.

  3. Atualize a configuração da tarefa existente:

    gcloud run jobs replace job.yaml

Terraform

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

Adicione o seguinte a um recurso google_cloud_run_v2_job na sua 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 o seguinte:

  • JOB_NAME: o nome da sua tarefa do Cloud Run.
  • REGION: a Google Cloud região. Por exemplo, europe-west1.
  • LABEL: o nome da etiqueta.
  • VALUE: o valor escolhido.

Liste empregos por etiqueta

Pode listar tarefas por etiqueta através de um filtro da CLI do Google Cloud:

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

Substitua o seguinte:

  • LABEL: o nome da etiqueta
  • VALUE: o valor a incluir na sua lista filtrada

Elimine uma etiqueta num trabalho

Para limpar todas as etiquetas de um trabalho: 

gcloud run jobs update JOB --clear-labels

Para eliminar etiquetas específicas de um serviço, forneça uma lista de chaves separadas por vírgulas: 

gcloud run jobs update JOB --remove-labels LABEL

Substitua o seguinte:

  • JOB: o nome da sua tarefa do Cloud Run
  • LABEL: o nome da sua editora