Configura etiquetas

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:

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

  1. 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.
  2. Para configurar una etiqueta en un trabajo existente, haz lo siguiente:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE
  3. 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

  1. 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
  2. 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.

  3. 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