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 ese 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 Google Cloud válidas.
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 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 permisos de implementación y el artículo sobre cómo gestionar el 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, localice 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. Ten 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 nueva 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 puedes 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, proporciona una lista de pares clave-valor delimitada por comas.
YAML
Si vas a crear un grupo de trabajadores, omite este paso. Si vas a actualizar un grupo de trabajadores, descarga su configuración YAML:
gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml
En el ejemplo siguiente se muestra la configuración de YAML:
apiVersion: run.googleapis.com/v1 kind: WorkerPool metadata: name: WORKER_POOL labels: KEY: VALUE KEY2: VALUE2 KEY3: VALUE3 annotations: run.googleapis.com/launch-stage: BETA
Haz los cambios siguientes:
- WORKER_POOL: el nombre de tu grupo de trabajadores de Cloud Run
- KEY y VALUE: los pares clave-valor de las etiquetas
Crea o actualiza el grupo de trabajadores con el siguiente comando:
gcloud beta run worker-pools replace workerpool.yaml
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: el 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 se 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 discográfica