As etiquetas do Cloud Run são pares de chave-valor aplicados a conjuntos de trabalhadores do Cloud Run. Esta página mostra como definir, modificar e eliminar etiquetas nos seus conjuntos de trabalhadores do Cloud Run. Tenha em atenção que, quando define uma etiqueta num conjunto de trabalhadores do Cloud Run, é criada uma nova revisão com esta etiqueta para este conjunto de trabalhadores. A etiqueta não é aplicada a revisões mais antigas.
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 conjunto de trabalhadores 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 e implementar pools de trabalhadores do Cloud Run, peça ao seu administrador que lhe conceda as seguintes funções da IAM:
-
Programador do Cloud Run (
roles/run.developer) no conjunto de trabalhadores do Cloud Run -
Utilizador da conta de serviço (
roles/iam.serviceAccountUser) na identidade do serviço
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 o seu conjunto de trabalhadores do Cloud Run interage com Google Cloud APIs, como as bibliotecas de clientes da nuvem, 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
Qualquer alteração de configuração leva à criação de uma nova revisão. As revisões subsequentes também vão receber automaticamente esta definição de configuração, a menos que faça atualizações explícitas para a alterar.
Pode definir ou modificar etiquetas através da Google Cloud consola, da CLI Google Cloud ou do Terraform:
Consola
Na Google Cloud consola, aceda ao Cloud Run:
Localize o conjunto de trabalhadores e selecione a caixa de verificação à esquerda do respetivo nome.
Clique em Etiquetas para apresentar o painel Etiquetas.
Para editar o valor de uma chave de etiqueta existente, localize a etiqueta e altere o Valor conforme pretendido.
Para definir uma nova etiqueta no conjunto de trabalhadores, clique em Adicionar etiqueta e indique a chave e o valor.
Clique em Guardar.
gcloud
Pode atualizar as etiquetas de um conjunto de trabalhadores com o comando:
gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE
Para atualizar mais de uma etiqueta, forneça uma lista de pares de chave e valor separados por vírgulas. Tenha em atenção que o comando update-labels define um novo valor para a chave da etiqueta se a etiqueta já existir. Caso contrário, cria uma nova etiqueta.
Substitua o seguinte:
- WORKER_POOL: o nome do seu conjunto de trabalhadores do Cloud Run
- KEY: o nome da chave da etiqueta
- VALUE: o valor da chave
Também pode definir etiquetas durante a implementação:
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
Para criar mais de uma etiqueta durante a implementação, forneça uma lista de pares de chave-valor separados por vírgulas.
Terraform
Para saber como aplicar ou remover uma configuração do Terraform, consulte os 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 o seguinte:
- WORKER_POOL: o nome do conjunto de trabalhadores
- REGION: a Google Cloud região, por exemplo,
europe-west1 - IMAGE_URL: uma referência à imagem do contentor que contém o conjunto de trabalhadores, como
us-docker.pkg.dev/cloudrun/container/worker-pool:latest - KEY: o nome da chave da etiqueta
- VALUE: o valor da chave
Liste serviços por etiqueta
Pode listar os serviços por etiqueta através de um filtro da CLI Google Cloud:
gcloud beta run worker-pools 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 conjunto de trabalhadores
Pode usar a Google Cloud consola ou a CLI Google Cloud para eliminar etiquetas num conjunto de trabalhadores.
Consola
Na Google Cloud consola, aceda ao Cloud Run:
Localize o conjunto de trabalhadores e selecione a caixa de verificação à esquerda do respetivo nome.
Clique em Etiquetas para apresentar o painel Etiquetas.
Localize a etiqueta que quer eliminar.
À direita da caixa de texto Valor da etiqueta, passe o cursor do rato para apresentar o ícone de lixo e, de seguida, clique no ícone de lixo.
Clique em Guardar.
gcloud
Para limpar todas as etiquetas de um conjunto de trabalhadores:
gcloud beta run worker-pools update WORKER_POOL --clear-labels
Para eliminar etiquetas específicas de um grupo de trabalhadores, forneça uma lista de chaves separadas por vírgulas:
gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL
Substitua o seguinte:
- WORKER_POOL: o nome do seu conjunto de trabalhadores do Cloud Run
- LABEL: o nome da sua editora