Configura el paralelismo de los 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 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 el paralelismo

Puedes configurar el paralelismo para un trabajo de Cloud Run con laGoogle Cloud consola, gcloud CLI, YAML o Terraform:

Console

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

    Ir a Cloud Run

  2. Selecciona Trabajos en el menú de navegación de Cloud Run:

    1. Si creas un trabajo nuevo, haz clic en Implementar contenedor para completar la página de configuración de trabajo inicial.

    2. Si quieres configurar un trabajo existente, selecciónalo y, luego, haz clic en Ver y editar la configuración del trabajo.

  3. Haz clic en Contenedores, Conexiones, Seguridad para expandir la página de propiedades del trabajo.

  4. En la sección Paralelismo, 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. Luego, especifica un número entero entre 0 y la cantidad máxima de tareas que se ejecutan en paralelo permitidas por la cuota que no excedan la cantidad de tareas.

  5. Haz clic en Crear o Actualizar.

gcloud

  • Para establecer el paralelismo cuando creas un trabajo nuevo, ejecuta el siguiente comando:

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

    Reemplaza lo siguiente:

    • JOB por el nombre del trabajo de Cloud Run.
    • IMAGE_URL: Es una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM: Es un número entero entre 0 y la cantidad máxima de tareas que se ejecutan en paralelo, permitida por la cuota, que no supera la cantidad de tareas.

  • Para actualizar el paralelismo de un trabajo existente, ejecuta el siguiente comando:

    gcloud run jobs update JOB --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 --format export > job.yaml

  2. Actualiza el atributo parallelism::

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

    Reemplaza lo siguiente:

    • JOB por el nombre del trabajo de Cloud Run.
    • IMAGE_URL: Es una referencia a la imagen del contenedor, por ejemplo, us-docker.pkg.dev/cloudrun/container/job:latest.
    • PARALLELISM: Es un número entero entre 0 y la cantidad máxima de tareas que se ejecutan en paralelo, permitida por la cuota, que no supera la cantidad de tareas.

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

  3. Crea o actualiza el servicio con el siguiente comando:

    gcloud run jobs replace job.yaml

    El comando gcloud run jobs replace usa de forma predeterminada el archivo job.yaml si está presente.

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     = "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, usa la consola de Google Cloud o Google Cloud CLI:

Console

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

    Ir a Trabajos de Cloud Run

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

  3. Haz clic en Ver y editar la configuración del trabajo.

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

gcloud

  1. Ejecuta el comando siguiente:

    gcloud run jobs describe JOB

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