Configurar etiquetas para los trabajos

Las etiquetas de Cloud Run son pares clave-valor que se aplican a las tareas de Cloud Run. En esta página se muestra cómo definir, modificar y eliminar etiquetas en tus trabajos de Cloud Run.

Entre los posibles usos, se incluyen los siguientes:

  • Desglose de la facturación y la asignación de costes.
  • Identifica los recursos que utilizan los distintos equipos o centros de costes.
  • Distinguir los entornos de implementación (producción, desarrollo, control de calidad o prueba).
  • Identifica a los propietarios y las etiquetas de estado.
  • Filtrar registros en Logging.

Reglas de uso de las etiquetas

Se aplica la siguiente regla al uso de etiquetas definidas en un trabajo de Cloud Run:

En Cloud Run solo se pueden usar etiquetas Google Cloud válidas.

Roles obligatorios

Para obtener los permisos que necesitas para configurar los trabajos de Cloud Run, pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos:

Para ver una lista de los roles y permisos de gestión de identidades y accesos asociados a Cloud Run, consulta los artículos sobre roles de gestión de identidades y accesos de Cloud Run y permisos de gestión de identidades y accesos de Cloud Run. Si tu trabajo de Cloud Run interactúa con APIs deGoogle Cloud , como las bibliotecas de cliente de Cloud, consulta la guía de configuración de la identidad de servicio. Para obtener más información sobre cómo conceder roles, consulta los artículos sobre permisos de implementación y gestión del acceso.

Definir o modificar etiquetas

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

gcloud

  1. Para asignar una etiqueta a un nuevo trabajo, sigue estos pasos:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE

    Haz los cambios siguientes:

    • JOB_NAME con el nombre del trabajo.
    • KEY con el nombre de la clave de tu etiqueta.
    • VALUE con 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 asignar una etiqueta a un trabajo que ya tengas, sigue estos pasos:

    gcloud run jobs update JOB_NAME --labels KEY=VALUE

  3. Para crear más de una etiqueta, proporciona una lista de pares clave-valor delimitada por comas.

    gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2

YAML

  1. Si vas a crear un trabajo, sáltate este paso. Si vas a actualizar una tarea, descarga su configuración 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

    Haz los cambios siguientes:

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

    También puede especificar más configuraciones, como variables de entorno o límites de memoria.

  3. Actualiza la configuración de la tarea:

    gcloud run jobs replace job.yaml

Terraform

Para saber cómo aplicar o quitar una configuración de Terraform, consulta Comandos básicos de Terraform.

Añade 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"
  }
}

Haz los cambios siguientes:

  • JOB_NAME: el nombre de tu tarea de Cloud Run.
  • REGION: la Google Cloud región. Por ejemplo, europe-west1.
  • LABEL: el nombre de la etiqueta.
  • VALUE: el valor elegido.

Mostrar tareas por etiqueta

Puedes enumerar los trabajos por etiqueta mediante un filtro de Google Cloud CLI:

  gcloud run jobs list --filter metadata.labels.LABEL=VALUE

Haz los cambios siguientes:

  • LABEL: el nombre de la etiqueta
  • VALUE: el valor que quieres incluir en la lista filtrada

Eliminar una etiqueta de una tarea

Para borrar todas las etiquetas de un trabajo: 

gcloud run jobs update JOB --clear-labels

Para eliminar etiquetas específicas de un servicio, proporciona una lista de claves delimitada por comas: 

gcloud run jobs update JOB --remove-labels LABEL

Haz los cambios siguientes:

  • JOB: el nombre de tu tarea de Cloud Run
  • LABEL: el nombre de tu sello