Configura el paralelismo (trabajos)

Usa parallelism para especificar la cantidad máxima de tareas en una ejecución de trabajo que se pueden ejecutar en paralelo. De forma predeterminada, las tareas se iniciarán lo más rápido posible, hasta un máximo que varía según la cantidad de CPU que uses:

La reducción del paralelismo limita cuántas tareas se ejecutan en paralelo. Esto es útil en los casos en que uno de tus recursos de copia de seguridad, como una base de datos, tiene un escalamiento limitado y no puede manejar una gran cantidad de solicitudes paralelas.

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 el paralelismo

A fin de especificar el paralelismo para un trabajo de Cloud Run, haz lo siguiente:

Console

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

    Ir a Cloud Run

  2. Haz clic en Implementar contenedor y selecciona Trabajo para completar la página de configuración de trabajo inicial. Si quieres configurar un trabajo existente, selecciona el trabajo y, luego, haz clic en Editar.

  3. Haz clic en Contenedor, variables y secretos, conexiones y seguridad para expandir la página de propiedades del trabajo.

  4. Haz clic en la pestaña General.

    imagen

    • Selecciona Ejecutar tantas tareas de forma simultánea como sea posible para obtener el mejor rendimiento. Si necesitas reducir la cantidad de tareas simultáneas, por ejemplo, si los recursos de copia de seguridad son limitados, selecciona Limita la cantidad de tareas simultáneas y, luego, especifica un número entero entre 0 y 100 en el cuadro de texto.

  5. Haz clic en Crear o Actualizar.

gcloud

  1. Para un trabajo que estés creando, sigue estos pasos:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --parallelism PARALLELISM

    Reemplazar

    • JOB_NAME por el nombre de tu trabajo.
    • IMAGE_URL por una referencia a la imagen del contenedor, como us-docker.pkg.dev/cloudrun/container/job:latest
    • PARALLELISM Especifica un número entero entre 0 y 100 que no exceda la cantidad de tareas.

  2. Para un trabajo que estás actualizando:

    gcloud run jobs update JOB_NAME --parallelism PARALLELISM

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 el atributo parallelism::

    apiVersion: run.googleapis.com/v1
kind: Job
metadata:
  name: JOB_NAME
spec:
  template:
    spec:
      parallelism: PARALLELISM
      template:
        spec:
          containers:
          - image: IMAGE

    Reemplaza PARALLELISM. Especifica un número entero entre 0 y 100 que no exceda la cantidad de tareas.

    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.

A fin de especificar el paralelismo para un trabajo de Cloud Run, usa el recurso google_cloud_run_v2_job y aplica el siguiente fragmento a tu archivo main.tf:

resource "google_cloud_run_v2_job" "default" {
  name     = "cloud-run-job-parallelism"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    task_count  = 3
    parallelism = 3

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

Ve la configuración de paralelismo

Para ver la configuración actual de paralelismo de tu trabajo de Cloud Run, sigue estos pasos:

Console

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

    Ir a Trabajos de Cloud Run

  2. Haz clic en el trabajo que te interesa para abrir la página Detalles del trabajo.

  3. Haz clic en la pestaña Configuración.

  4. Ubica la configuración de paralelismo en los detalles de configuración.

gcloud

  1. Usa el siguiente comando:

    gcloud run jobs describe JOB_NAME

  2. Busca la configuración de paralelismo en la configuración mostrada.