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 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 la Google Cloud consola 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 Google Cloud las 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 permisos de implementación y administra el acceso.

Configura o modifica etiquetas

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

Console

  1. En la Google Cloud consola, 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 (Valor).

  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 por el valor de la clave.
    • IMAGE_URL: 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 por el nombre de la etiqueta.
    • VALUE por 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 Facturación de Cloud y Cloud Logging.

  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 google_cloud_run_v2_job recurso en la 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: Es 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 la 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: Es el nombre del trabajo de Cloud Run.
  • LABEL: Es el nombre de la etiqueta.