Configura etiquetas para grupos de trabajadores

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:

Asignación de costos y desgloses de 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).
Identifica propietarios y etiquetas de estado
Filtra registros en Logging.

Reglas de uso de etiquetas

Se aplica la siguiente regla al uso de etiquetas establecidas en un grupo de trabajadores de Cloud Run:

Solo se pueden usar etiquetasválidas Google Cloud en Cloud Run.

Etiquetas para datos de facturación y Logging

Facturación de Cloud y Cloud Logging solo reciben etiquetas que se especifican en el atributo spec.template.metadata.labels en YAML o en template en Terraform. Si configuras etiquetas con el 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 y, luego, implementar los 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 etiquetas con la Google Cloud consola de, Google Cloud CLI, o Terraform:

Console

En la consola Google Cloud , ve a Cloud Run:

Ir a Cloud Run
Ubica 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: Es el nombre de tu grupo de trabajadores de Cloud Run.
KEY: Es el nombre de la clave de tu 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 > workerpool.yaml
```
En el siguiente ejemplo, se incluye la configuración de YAML:
```
apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3
```
Reemplaza lo siguiente:
- WORKER_POOL: Es el nombre de tu grupo de trabajadores de Cloud Run.
- KEY y VALUE: Son los pares clave-valor de las etiquetas.
metadata.labels establece etiquetas en el objeto de grupo de trabajadores, mientras que spec.template.metadata.labels establece etiquetas en la revisión creada. Cloud Run solo propaga las etiquetas establecidas en la revisión a Facturación de Cloud y Cloud Logging.
Crea o actualiza el grupo de trabajadores con el siguiente comando:
```
gcloud run worker-pools replace workerpool.yaml
```

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"
    }
  }
}

Reemplaza lo siguiente:

WORKER_POOL: Es el nombre del grupo de trabajadores.
REGION: Es la Google Cloud región, por ejemplo, europe-west1.
IMAGE_URL: Es una referencia a la imagen del contenedor que contiene el grupo de trabajadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
KEY: Es el nombre de la clave de tu etiqueta.
VALUE: Es el valor de la clave.

Si agregas las etiquetas en template, se establecen las etiquetas de revisión. Cloud Run solo propaga las etiquetas establecidas en la revisión a Cloud Logging y Facturación de Cloud. Si agregas las etiquetas a una ubicación que no sea en template, la etiqueta se establece para el grupo de trabajadores, no para la revisión.

Enumera grupos de trabajadores por etiqueta

Puedes enumerar grupos de trabajadores por etiqueta mediante un filtro de Google Cloud CLI:

  gcloud run worker-pools list --filter metadata.labels.LABEL=VALUE

Reemplaza lo siguiente:

LABEL: Es el nombre de la etiqueta.
VALUE: Es el valor que se incluirá en tu lista filtrada.

Borra una etiqueta en un grupo de trabajadores

Puedes usar la Google Cloud consola de o Google Cloud CLI para borrar etiquetas en un grupo de trabajadores.

Console

En la consola Google Cloud , ve a Cloud Run:

Ir a Cloud Run
Ubica 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, ejecuta 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: Es el nombre de tu grupo de trabajadores de Cloud Run.
LABEL: Es el nombre de tu etiqueta.

Configura etiquetas para grupos de trabajadores Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Reglas de uso de etiquetas

Etiquetas para datos de facturación y Logging

Roles obligatorios

Configura o modifica etiquetas

Console

gcloud

YAML

Terraform

Enumera grupos de trabajadores por etiqueta

Borra una etiqueta en un grupo de trabajadores

Console

gcloud

Configura etiquetas para grupos de trabajadores