Configura etiquetas para los trabajos

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 Google Cloud válidas en Cloud Run.

Etiquetas para el registro y los datos de facturación

Cloud Logging y la Facturación de Cloud solo reciben las etiquetas especificadas en el atributo spec.template.metadata.labels en YAML o en template en Terraform. Si configuras etiquetas con la consola deGoogle Cloud o 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 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 los roles de IAM de Cloud Run y los permisos de IAM de Cloud Run. Si tu trabajo 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

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

Console

  1. En la consola de Google Cloud , ve a la página Trabajos de Cloud Run:

    Ir a Cloud Run

  2. Marca la casilla de verificación a la izquierda del trabajo en el que configurarás la etiqueta.

  3. Asegúrate de que el Panel de información en el extremo derecho esté activado (Mostrar panel de información).

  4. Haz clic en Etiquetas para mostrar el panel de etiquetas.

    Establece etiquetas

  5. Para editar un valor de una clave de etiqueta existente, ubica la etiqueta y cambia el Value.

  6. Para establecer una etiqueta nueva en el servicio, haz clic en Agregar etiqueta y proporciona la clave y el valor.

  7. Haz clic en Guardar.

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

    Reemplaza lo siguiente:

    • JOB_NAME por el nombre de tu trabajo.
    • KEY por el nombre de la clave de etiqueta
    • VALUE con el valor de la clave
    • IMAGE_URL: Es una referencia a la imagen del contenedor, por ejemplo, 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

    Reemplaza lo siguiente:

    • LABEL con el nombre de la etiqueta.
    • VALUE con el valor elegido.

    También puedes especificar más opciones de configuración, como variables de entorno o límites de memoria.

    Cloud Run solo propaga las etiquetas establecidas en el atributo spec.template.metadata.labels a Cloud Logging y a la Facturación de Cloud.

  3. Actualiza la configuración del trabajo existente:

    gcloud run jobs replace job.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.

Agrega lo siguiente a un recurso google_cloud_run_v2_job en tu configuración de Terraform:

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

Reemplaza lo siguiente:

  • JOB_NAME por el nombre del trabajo de Cloud Run.
  • REGION: La Google Cloud región Por ejemplo, europe-west1.
  • LABEL: Es el nombre de la etiqueta.
  • VALUE: Es el valor elegido.

Cloud Run solo propaga las etiquetas establecidas en template a Facturación de Cloud y Cloud Logging.

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: Es el nombre de la etiqueta.
  • VALUE: Es 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

Reemplaza lo siguiente:

  • JOB: El nombre de tu trabajo de Cloud Run
  • LABEL: El nombre de tu etiqueta