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 rótulos Google Cloud válidos podem ser usados no Cloud Run.

Funções exigidas

Para receber as permissões necessárias para configurar e implantar pools de trabalhadores 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 trabalhadores 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

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 a Google Cloud CLI ao criar um novo pool de trabalhadores ou implantar uma nova revisão:

gcloud

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

gcloud beta 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 e 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 pelo nome do pool de workers do Cloud Run.
  • KEY pelo nome da chave do rótulo;
  • VALUE pelo valor da chave.

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

gcloud beta 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.

Listar serviços por rótulo

É possível listar serviços por rótulo usando um filtro da CLI do Google Cloud:

  gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE

Substitua:

  • LABEL pelo nome do rótulo;
  • VALUE pelo valor a ser incluído na lista filtrada

Excluir um rótulo de um pool de workers

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

gcloud

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

gcloud beta 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 beta run worker-pools update WORKER_POOL --remove-labels LABEL

Substitua:

  • WORKER_POOL pelo nome do pool de workers do Cloud Run.
  • LABEL pelo nome do rótulo