Las etiquetas de Cloud Run son pares clave-valor que se aplican a los trabajos de Cloud Run. En esta página, se muestra cómo configurar, modificar y borrar etiquetas en tus 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.
Roles obligatorios
Para obtener los permisos que necesitas para configurar los trabajos 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 trabajo 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 Roles de IAM de Cloud Run y Permisos de IAM de Cloud Run. Si tu trabajo de Cloud Run interactúa con las APIs de Google Cloud, como las bibliotecas cliente de Cloud, consulta la guía de configuración de identidades del servicio. Para obtener más información acerca de cómo otorgar roles, consulta Permisos de implementación y Administra el acceso.
Configura o modifica etiquetas
Puedes usar Google Cloud CLI o YAML para configurar una etiqueta en un trabajo de Cloud Run.
gcloud
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
Si creas un trabajo nuevo, omite este paso. Si actualizas un trabajo existente, descarga su configuración de YAML:
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
Reemplazar
- 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