Configura etiquetas

Las etiquetas de Cloud Run son pares clave-valor que se aplican a trabajos de Cloud Run. En esta página, se muestra cómo configurar, modificar y borrar etiquetas en los trabajos de Cloud Run.

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 trabajo de Cloud Run:

Solo se pueden usar etiquetas de Google Cloud válidas en Cloud Run.

Configura o modifica etiquetas

Puedes usar Google Cloud CLI o YAML para establecer una etiqueta en un trabajo de Cloud Run.

Línea de comandos

Para configurar una etiqueta en un trabajo nuevo, sigue estos pasos:
```
gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE
```
Reemplazar
- JOB_NAME por el nombre de tu trabajo.
- KEY por el nombre de la clave de etiqueta
- VALUE por el valor de la clave
- Reemplaza IMAGE_URL por una referencia a la imagen de contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest.
Para configurar una etiqueta en un trabajo existente, haz lo siguiente:
```
gcloud run jobs update JOB_NAME --labels KEY=VALUE
```
Para crear más de una etiqueta, proporciona una lista delimitada por comas de pares clave-valor.
```
gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2 
```

YAML

Descarga y visualiza la configuración del trabajo existente mediante el comando gcloud run jobs describe --format export, que genera resultados limpios en formato YAML. Luego, modifica los campos que se describen a continuación y sube el YAML modificado mediante el comando gcloud run jobs replace. Asegúrate de modificar los campos tal como se indica en la documentación.

Para ver y descargar la configuración:

gcloud run jobs describe JOB_NAME --format export > job.yaml

Actualiza los atributos labels en dos lugares:
```
apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  labels:
    LABEL: VALUE
spec:
  template:
    metadata:
      labels:
        LABEL: VALUE
```
Reemplaza los siguientes elementos:
- LABEL por el nombre de la etiqueta
- VALUE por el valor deseado
También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.
Actualiza la configuración del trabajo existente:
```
gcloud run jobs replace job.yaml
```

Enumera trabajos por etiqueta

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

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE

Reemplaza lo siguiente:

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

Borra una etiqueta de un trabajo

Para borrar todas las etiquetas de un servicio, ejecuta lo siguiente:

gcloud run jobs update JOB --clear-labels

Para borrar etiquetas específicas de un servicio, proporciona una lista de claves delimitadas por comas:

gcloud run jobs update JOB --remove-labels LABEL

Reemplazar

JOB por el nombre del trabajo de Cloud Run.
LABEL por el nombre de tu etiqueta