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 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.
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:
-
Desenvolvedor do Cloud Run (
roles/run.developer) no pool de worker do Cloud Run -
Usuário da conta de serviço (
roles/iam.serviceAccountUser) na identidade do serviço
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 o console Google Cloud , a Google Cloud CLI ou o Terraform:
Console
No Google Cloud console, acesse o Cloud Run:
Localize o pool de worker e marque a caixa de seleção à esquerda do nome dele.
Clique em Rótulos para exibir o painel de rótulos.
Para editar um valor-chave de rótulo atual, localize o rótulo e mude o Valor como quiser.
Para definir um novo rótulo no pool de workers, clique em Adicionar rótulo e forneça a chave e o valor.
Clique em Salvar.
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: o nome do seu pool de worker 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 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.
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"
launch_stage = "BETA"
template {
containers {
image = "IMAGE_URL"
}
}
labels = {
KEY : "VALUE"
}
}
Substitua:
- WORKER_POOL: o nome do pool de workers
- REGION: a região 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.
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: o nome do rótulo
- VALUE: o valor a ser incluído na lista filtrada
Excluir um rótulo de um pool de workers
É possível usar o console Google Cloud ou a Google Cloud CLI para excluir rótulos em um pool de trabalhadores.
Console
No Google Cloud console, acesse o Cloud Run:
Localize o pool de worker e marque a caixa de seleção à esquerda do nome dele.
Clique em Rótulos para exibir o painel de rótulos.
Localize o rótulo que você quer excluir.
À direita da caixa de texto Valor do rótulo, passe o cursor para mostrar o ícone de lixeira e clique nele.
Clique em Salvar.
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: o nome do seu pool de worker do Cloud Run
- LABEL: o nome do seu rótulo