Configurar rótulos para pools de workers

Os rótulos do Cloud Run são pares de chave-valor aplicados a pools de workers do Cloud Run. Nesta página, mostramos como definir, modificar e excluir rótulos nos pools de workers do Cloud Run. Quando você define um rótulo em um pool de workers do Cloud Run, uma nova revisão com esse rótulo é criada para esse pool. O rótulo não é aplicado a revisões mais antigas.

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 pool de workers do Cloud Run:

Somente válidos Google Cloud rótulos 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 em no atributo spec.template.metadata.labels em YAML ou em template em Terraform. Se você configurar rótulos usando 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 e implantar pools de workers 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 pool de workers do Cloud Run interagir com Google Cloud APIs, 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

Qualquer mudança na configuração leva à criação de uma nova revisão. As próximas revisões também recebem automaticamente essa configuração, a menos que você faça atualizações explícitas para alterá-la.

É possível definir ou modificar rótulos usando o Google Cloud console, a Google Cloud CLI ou o Terraform:

Console

  1. No Google Cloud console, acesse o Cloud Run:

    Acessar o Cloud Run

  2. Localize o pool de workers e selecione a caixa de seleção à esquerda do nome dele.

  3. Clique em Rótulos para mostrar o painel "Rótulos".

    Definir rótulo

  4. Para editar um valor de chave de rótulo atual, localize o rótulo e mude o Valor como quiser.

  5. Para definir um novo rótulo no pool de workers, clique em Adicionar rótulo e forneça a chave e o valor.

  6. Clique em Salvar.

gcloud

É possível atualizar rótulos de um pool de workers usando o comando:

gcloud run worker-pools update WORKER_POOL --update-labels KEY=VALUE

Para atualizar mais de um rótulo, forneça uma lista delimitada por vírgulas de pares de chave-valor. Observe que o comando update-labels define um novo valor para a chave de rótulo , se ele já existir. Caso contrário, ele criará um novo rótulo.

Substitua:

  • WORKER_POOL: o nome do pool de workers do Cloud Run
  • KEY: o nome da chave do rótulo
  • VALUE: o valor da chave

Também é possível definir rótulos durante a implantação:

gcloud run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

Para criar mais de um rótulo durante a implantação, forneça uma lista de pares chave-valor delimitada por vírgulas.

YAML

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

    gcloud run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. O exemplo a seguir contém a configuração YAML:

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    Substitua:

    • WORKER_POOL: o nome do pool de workers do Cloud Run
    • KEY e VALUE: os pares de chave-valor para rótulos

    metadata.labels define rótulos no objeto do pool de workers, enquanto spec.template.metadata.labels define rótulos na revisão criada. O Cloud Run só propaga rótulos definidos na revisão para o Cloud Billing e o Cloud Logging.

  3. Crie ou atualize o pool de workers usando o comando a seguir:

    gcloud run worker-pools replace workerpool.yaml

Terraform

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

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
    }
    labels = {
      KEY : "VALUE"
    }
  }
}

Substitua:

  • WORKER_POOL: o nome do pool de workers
  • REGION: a Google Cloud região, por exemplo, europe-west1
  • IMAGE_URL: uma referência à imagem de contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • KEY: o nome da chave do rótulo
  • VALUE: o valor da chave

Adicionar os rótulos em template define os rótulos de revisão. O Cloud Run só propaga rótulos definidos na revisão para o Cloud Logging e o Cloud Billing. Se você adicionar os rótulos a um local diferente de template, o rótulo será definido para o pool de workers, não para a revisão.

Listar pools de workers por rótulo

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

  gcloud run worker-pools 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 rótulo em um pool de workers

É possível usar o Google Cloud console ou a Google Cloud CLI para excluir rótulos em um pool de workers.

Console

  1. No Google Cloud console, acesse o Cloud Run:

    Acessar o Cloud Run

  2. Localize o pool de workers e selecione a caixa de seleção à esquerda do nome dele.

  3. Clique em Rótulos para mostrar o painel "Rótulos".

    Definir rótulo

  4. Localize o rótulo que você quer excluir.

  5. À direita da caixa de texto Valor do rótulo, passe o cursor para mostrar o ícone de lixeira e clique nele.

  6. Clique em Salvar.

gcloud

Para limpar todos os rótulos de um pool de workers:

gcloud run worker-pools update WORKER_POOL --clear-labels

Para excluir rótulos específicos de um pool de workers, forneça uma lista de chaves delimitada por vírgulas:

gcloud run worker-pools update WORKER_POOL --remove-labels LABEL

Substitua:

  • WORKER_POOL: o nome do pool de workers do Cloud Run
  • LABEL: o nome do rótulo