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.

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 las APIs deGoogle Cloud , 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 CLI, YAML o Terraform 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 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

    Reemplazar

    • LABEL por 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.

  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 = "us-central1"

  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.
  • LABEL por el nombre de la etiqueta.
  • VALUE con el valor elegido.

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