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 de workers. 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 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 pool de workers 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 só recebe rótulos especificados no atributo metadata.labels no YAML ou no argumento labels de nível superior no Terraform. O Cloud Logging só recebe rótulos especificados no atributo spec.template.metadata.labels em YAML ou em template no Terraform. Para propagar rótulos para o Cloud Billing e o Cloud Logging, especifique rótulos nos dois lugares ao usar YAML ou Terraform. Se você configurar rótulos usando o console do Google 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 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 APIs doGoogle 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

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 console do Google Cloud , a Google Cloud CLI, o YAML ou o Terraform:

Console

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

    Acessar o Cloud Run

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

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

    Definir rótulo

  4. Para editar um valor-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

Atualize os 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. 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 delimitada por vírgulas de pares de chave-valor.

YAML

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

    gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
  2. Atualize os atributos labels em dois lugares:

    apiVersion: run.googleapis.com/v1
    kind: WorkerPool
    metadata:
      name: WORKER_POOL
      labels:
        KEY: VALUE
        KEY2: VALUE2
        KEY3: VALUE3
    spec:
      template:
        metadata:
          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 e valor para rótulos.

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

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

    gcloud run worker-pools replace worker-pool.yaml

    O comando gcloud run worker-pools replace usa o arquivo worker-pool.yaml por padrão, se ele estiver presente.

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"
    }
  }
  labels = {
    "KEY" : "VALUE"
  }
}

Substitua:

  • WORKER_POOL: o nome do pool de workers
  • REGION: a região do Google Cloud , 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.

O argumento labels de nível superior define rótulos no pool de workers, enquanto o argumento labels em template define rótulos na revisão. O Cloud Run propaga o labels de nível superior para o Cloud Billing e o labels definido em template para o Cloud Logging.

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 console do Google Cloud ou a Google Cloud CLI para excluir rótulos em um pool de workers.

Console

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

    Acessar o Cloud Run

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

  3. Clique em Rótulos para exibir 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 exibir 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.