Las etiquetas de Cloud Run son pares clave-valor que se aplican a los grupos de trabajadores de Cloud Run. En esta página, se muestra cómo configurar, modificar y borrar etiquetas en tus grupos de trabajadores de Cloud Run. Ten en cuenta que, cuando configuras una etiqueta en un grupo de trabajadores de Cloud Run, se crea una revisión nueva con esta etiqueta para este grupo de trabajadores. La etiqueta no se aplica a revisiones anteriores.
Entre los usos posibles, se incluyen los siguientes:
- Asignar costos y desglosar la facturación
- Identifica los recursos que usan los equipos individuales o los centros de costos.
- Distingue los entornos de implementación (producción, etapa de pruebas, control de calidad o prueba).
- Identificar propietarios y etiquetas de estado
- Filtra registros en Logging.
Reglas de uso de etiquetas
La siguiente regla se aplica al uso de etiquetas configuradas en un grupo de trabajadores de Cloud Run:
Solo se pueden usar etiquetas Google Cloud válidas en Cloud Run.
Etiquetas para datos de facturación y registro
La Facturación de Cloud solo recibe las etiquetas que se especifican en el atributometadata.labels
en YAML o en el argumento labels de nivel superior en Terraform.
Cloud Logging solo recibe las etiquetas que se especifican en el
atributo spec.template.metadata.labels en YAML o en template en
Terraform. Para propagar etiquetas a la Facturación de Cloud y a Cloud Logging,
especifica etiquetas en ambos lugares cuando uses YAML o Terraform. Si configuras
etiquetas con la consola de Google Cloud o Google Cloud CLI, Cloud Run agrega
las etiquetas a los atributos metadata.labels y spec.template.metadata.labels.
Roles obligatorios
Para obtener los permisos que necesitas para configurar e implementar grupos de trabajadores de Cloud Run, pídele a tu administrador que te otorgue los siguientes roles de IAM:
- Desarrollador de Cloud Run (
roles/run.developer) en el grupo de trabajadores de Cloud Run - Usuario de la cuenta de servicio (
roles/iam.serviceAccountUser) en la identidad del servicio
Para obtener una lista de los roles y los permisos de IAM asociados con Cloud Run, consulta los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu grupo de trabajadores de Cloud Run interactúa con lasGoogle Cloud APIs, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información sobre cómo otorgar roles, consulta los permisos de implementación y cómo administrar el acceso.
Configura o modifica etiquetas
Cualquier cambio en la configuración conlleva la creación de una revisión nueva. Las revisiones posteriores también adoptarán esta configuración de manera automática, a menos que realices actualizaciones explícitas para cambiarla.
Puedes configurar o modificar las etiquetas con la consola de Google Cloud , Google Cloud CLI, YAML o Terraform:
Console
En la consola Google Cloud , ve a Cloud Run:
Busca el grupo de trabajadores y selecciona la casilla de verificación a la izquierda de su nombre.
Haz clic en Etiquetas para mostrar el panel de etiquetas.
Para editar un valor de una clave de etiqueta existente, ubica la etiqueta y cambia el Value (Valor) como desees.
Para establecer una etiqueta nueva en el grupo de trabajadores, haz clic en Agregar etiqueta y proporciona la clave y el valor.
Haga clic en Guardar.
gcloud
Puedes actualizar las etiquetas de un grupo de trabajadores con el siguiente comando:
gcloud run worker-pools update WORKER_POOL --update-labels KEY=VALUE
Para actualizar más de una etiqueta, proporciona una lista delimitada por comas de pares clave-valor. Ten en cuenta que el comando update-labels establece un valor nuevo para la clave de etiqueta si la etiqueta ya existe; de lo contrario, crea una etiqueta nueva.
Reemplaza lo siguiente:
- WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run
- KEY: el nombre de la clave de etiqueta
- VALUE: Es el valor de la clave.
También puedes establecer etiquetas durante la implementación:
gcloud run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
Para crear más de una etiqueta durante la implementación, proporciona una lista delimitada por comas de pares clave-valor.
YAML
Si creas un grupo de trabajadores nuevo, omite este paso. Si actualizas un grupo de trabajadores existente, descarga su configuración de YAML:
gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
Actualiza los atributos
labelsen dos 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
Reemplaza lo siguiente:
- WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run
- KEY y VALUE: Son los pares clave-valor para las etiquetas.
metadata.labelsestablece etiquetas en el objeto del grupo de trabajadores, mientras quespec.template.metadata.labelsestablece etiquetas en la revisión creada. Cloud Run propaga las etiquetas establecidas enmetadata.labelsa Facturación de Cloud y las etiquetas establecidas enspec.template.metadata.labelsa Cloud Logging.Crea o actualiza el grupo de trabajadores con el siguiente comando:
gcloud run worker-pools replace worker-pool.yaml
El comando
gcloud run worker-pools replaceusa el archivoworker-pool.yamlde forma predeterminada si está presente.
Terraform
Si deseas obtener más información para aplicar o quitar una configuración de Terraform, consulta los comandos básicos de 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"
}
}
Reemplaza lo siguiente:
- WORKER_POOL: Es el nombre del grupo de trabajadores.
- REGION: la región de Google Cloud , por ejemplo,
europe-west1 IMAGE_URL: Es una referencia a la imagen de contenedor que contiene el grupo de trabajadores, comous-docker.pkg.dev/cloudrun/container/worker-pool:latest.- KEY: el nombre de la clave de etiqueta
- VALUE: Es el valor de la clave.
El argumento labels de nivel superior establece etiquetas en el grupo de trabajadores, mientras que el
argumento labels en template establece etiquetas en la revisión.
Cloud Run propaga las labels de nivel superior a la Facturación de Cloud y
propaga las labels establecidas en template a Cloud Logging.
Enumera los grupos de trabajadores por etiqueta
Puedes enumerar grupos de trabajadores por etiqueta con un filtro de Google Cloud CLI:
gcloud run worker-pools list --filter metadata.labels.LABEL=VALUE
Reemplaza lo siguiente:
- LABEL: el nombre de la etiqueta
- VALUE: Es el valor que se incluirá en tu lista filtrada.
Borra una etiqueta de un grupo de trabajadores
Puedes usar la consola de Google Cloud o Google Cloud CLI para borrar etiquetas en un grupo de trabajadores.
Console
En la consola Google Cloud , ve a Cloud Run:
Busca el grupo de trabajadores y selecciona la casilla de verificación a la izquierda de su nombre.
Haz clic en Etiquetas para mostrar el panel de etiquetas.
Ubica la etiqueta que deseas borrar.
A la derecha del cuadro de texto Valor de la etiqueta, coloca el cursor para mostrar el ícono de la papelera y, luego, haz clic en él.
Haga clic en Guardar.
gcloud
Para borrar todas las etiquetas de un grupo de trabajadores, haz lo siguiente:
gcloud run worker-pools update WORKER_POOL --clear-labels
Para borrar etiquetas específicas de un grupo de trabajadores, proporciona una lista de claves delimitadas por comas:
gcloud run worker-pools update WORKER_POOL --remove-labels LABEL
Reemplaza lo siguiente:
- WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run
- LABEL: Es el nombre de tu etiqueta.