Las etiquetas de Cloud Run son pares clave-valor que se aplican a los grupos de trabajo de Cloud Run. En esta página se muestra cómo definir, modificar y eliminar etiquetas en tus grupos de trabajadores de Cloud Run. Ten en cuenta que, cuando asignas una etiqueta a un grupo de trabajadores de Cloud Run, se crea una nueva revisión con esa etiqueta para el grupo de trabajadores. La etiqueta no se aplica a las revisiones anteriores.
Entre los posibles usos, se incluyen los siguientes:
- Desglose de la facturación y la asignación de costes.
- Identifica los recursos que utilizan los distintos equipos o centros de costes.
- Distinguir los entornos de implementación (producción, desarrollo, control de calidad o prueba).
- Identifica a los propietarios y las etiquetas de estado.
- Filtrar registros en Logging.
Reglas de uso de las etiquetas
Se aplica la siguiente regla al uso de etiquetas definidas en un grupo de trabajadores de Cloud Run:
En Cloud Run solo se pueden usar etiquetas válidas Google Cloud .
Roles obligatorios
Para obtener los permisos que necesitas para configurar e implementar grupos de trabajadores de Cloud Run, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:
-
Desarrollador de Cloud Run (
roles/run.developer) en el grupo de trabajadores de Cloud Run -
Usuario de cuenta de servicio (
roles/iam.serviceAccountUser) en la identidad de servicio
Para ver una lista de los roles y permisos de gestión de identidades y accesos asociados a Cloud Run, consulta los artículos sobre roles de gestión de identidades y accesos de Cloud Run y permisos de gestión de identidades y accesos de Cloud Run. Si tu grupo de trabajadores de Cloud Run interactúa con APIs deGoogle Cloud , como las bibliotecas de cliente de Cloud, consulta la guía de configuración de identidades de servicio. Para obtener más información sobre cómo conceder roles, consulta los artículos sobre permisos de implementación y gestión del acceso.
Definir o modificar etiquetas
Cualquier cambio en la configuración conlleva la creación de una nueva revisión. Las revisiones posteriores también recibirán automáticamente este ajuste de configuración, a menos que hagas cambios explícitos para modificarlo.
Puedes definir o modificar etiquetas con la Google Cloud consola, la CLI de Google Cloud o Terraform:
Consola
En la Google Cloud consola, ve a Cloud Run:
Busca el grupo de trabajadores y selecciona la casilla situada a la izquierda de su nombre.
Haz clic en Etiquetas para que se muestre el panel Etiquetas.
Para editar el valor de una clave de etiqueta, busque la etiqueta y cambie el Valor como quiera.
Para definir una etiqueta en el grupo de trabajadores, haga clic en Añadir etiqueta y proporcione la clave y el valor.
Haz clic en Guardar.
gcloud
Puedes actualizar las etiquetas de un grupo de trabajadores con el siguiente comando:
gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE
Para actualizar más de una etiqueta, proporciona una lista de pares clave-valor separados por comas. Tenga en cuenta que el comando update-labels asigna un nuevo valor a la clave de la etiqueta si esta ya existe. De lo contrario, crea una etiqueta.
Haz los cambios siguientes:
- WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run
- KEY: el nombre de la clave de la etiqueta
- VALUE: el valor de la clave
También puede definir etiquetas durante la implementación:
gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE
Para crear más de una etiqueta durante la implementación, proporcione una lista de pares clave-valor delimitada por comas.
Terraform
Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de 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"
}
}
Haz los cambios siguientes:
- WORKER_POOL: nombre del grupo de trabajadores
- REGION: la Google Cloud región (por ejemplo,
europe-west1 - IMAGE_URL: una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como
us-docker.pkg.dev/cloudrun/container/worker-pool:latest - KEY: el nombre de la clave de la etiqueta
- VALUE: el valor de la clave
Mostrar servicios por etiqueta
Puedes enumerar los servicios por etiqueta mediante un filtro de Google Cloud CLI:
gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE
Haz los cambios siguientes:
- LABEL: el nombre de la etiqueta
- VALUE: el valor que quieres incluir en la lista filtrada
Eliminar una etiqueta de un grupo de trabajadores
Puedes usar la Google Cloud consola o la CLI de Google Cloud para eliminar etiquetas de un grupo de trabajadores.
Consola
En la Google Cloud consola, ve a Cloud Run:
Busca el grupo de trabajadores y selecciona la casilla situada a la izquierda de su nombre.
Haz clic en Etiquetas para que se muestre el panel Etiquetas.
Busca la etiqueta que quieras eliminar.
A la derecha del cuadro de texto Valor de la etiqueta, coloca el cursor para que se muestre el icono de la papelera y, a continuación, haz clic en él.
Haz clic en Guardar.
gcloud
Para borrar todas las etiquetas de un grupo de trabajadores, sigue estos pasos:
gcloud beta run worker-pools update WORKER_POOL --clear-labels
Para eliminar etiquetas específicas de un grupo de trabajadores, proporciona una lista de claves delimitada por comas:
gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL
Haz los cambios siguientes:
- WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run
- LABEL: el nombre de tu sello