Définir le parallélisme pour les jobs

Vous pouvez utiliser parallelism pour spécifier le nombre maximal de tâches d'une exécution de job pouvant s'exécuter en parallèle. Par défaut, les tâches sont démarrées le plus rapidement possible, dans la limite du nombre de processeurs que vous utilisez.

La réduction du parallélisme limite le nombre de tâches exécutées en parallèle. Cela est utile dans les cas où l'une de vos ressources de sauvegarde, telle qu'une base de données, présente un scaling limité et ne peut pas gérer un grand nombre de requêtes parallèles.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer des jobs Cloud Run, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Pour obtenir la liste des rôles et des autorisations IAM associés à Cloud Run, consultez les sections Rôles IAM Cloud Run et Autorisations IAM Cloud Run. Si votre job Cloud Run communique avec des APIGoogle Cloud , telles que des bibliothèques clientes Cloud, consultez le guide de configuration de l'identité du service. Pour en savoir plus sur l'attribution de rôles, consultez les pages Autorisations de déploiement et Gérer les accès.

Configurer le parallélisme

Vous pouvez configurer le parallélisme pour un job Cloud Run à l'aide de la consoleGoogle Cloud , de la gcloud CLI, de YAML ou de Terraform :

Console

  1. Dans la console Google Cloud , accédez à la page Cloud Run :

    Accédez à Cloud Run

  2. Sélectionnez Jobs dans le menu de navigation Cloud Run :

    1. Si vous créez un job, cliquez sur Déployer un conteneur pour remplir la page des paramètres initiaux du job.

    2. Si vous configurez un job existant, sélectionnez-le, puis cliquez sur Afficher et modifier la configuration du job.

  3. Cliquez sur Conteneurs, Connexions, Sécurité pour développer la page des propriétés du job.

  4. Dans la section Parallélisme, sélectionnez Exécuter simultanément autant de tâches que possible pour optimiser les performances. Si vous devez réduire le nombre de tâches simultanées, par exemple si vos ressources de sauvegarde sont limitées, sélectionnez Limiter le nombre de tâches simultanées. Spécifiez ensuite un entier compris entre 0 et le nombre maximal de tâches exécutées en parallèle autorisé par le quota, sans dépasser le nombre de tâches.

  5. Cliquez sur Créer ou Mettre à jour.

gcloud

  • Pour définir le parallélisme lorsque vous créez un job, exécutez la commande suivante :

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

    Remplacez les éléments suivants :

    • JOB par le nom de votre job Cloud Run
    • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
    • PARALLELISM : entier compris entre 0 et le nombre maximal de tâches exécutées en parallèle, autorisé par le quota, qui ne dépasse pas le nombre de tâches.

  • Pour mettre à jour le parallélisme d'un job existant, exécutez la commande suivante :

    gcloud run jobs update JOB --parallelism PARALLELISM

YAML

  1. Si vous créez un job, ignorez cette étape. Si vous mettez à jour un job existant, téléchargez sa configuration YAML :

    gcloud run jobs describe JOB --format export > job.yaml

  2. Mettez à jour l'attribut parallelism: :

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

    Remplacez les éléments suivants :

    • JOB par le nom de votre job Cloud Run
    • IMAGE_URL : référence à l'image de conteneur (par exemple, us-docker.pkg.dev/cloudrun/container/job:latest).
    • PARALLELISM : entier compris entre 0 et le nombre maximal de tâches exécutées en parallèle, autorisé par le quota, qui ne dépasse pas le nombre de tâches.

    Vous pouvez également spécifier d'autres éléments de configuration, tels que des variables d'environnement ou des limites de mémoire.

  3. Créez ou mettez à jour le job à l'aide de la commande suivante :

    gcloud run jobs replace job.yaml

    Par défaut, la commande gcloud run jobs replace utilise le fichier job.yaml s'il est présent.

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

Ajoutez les éléments suivants à une ressource google_cloud_run_v2_job dans votre configuration 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"
      }
    }
  }
}

Afficher les paramètres du parallélisme

Pour afficher les paramètres de parallélisme actuels de votre job Cloud Run, utilisez la console Google Cloud ou la Google Cloud CLI :

Console

  1. Dans la console Google Cloud , accédez à la page des jobs Cloud Run :

    Accéder aux jobs Cloud Run

  2. Cliquez sur le job pour ouvrir la page Informations sur le job.

  3. Cliquez sur Afficher et modifier la configuration du job.

  4. Recherchez le paramètre de parallélisme dans les détails de la configuration.

gcloud

  1. Exécutez la commande suivante :

    gcloud run jobs describe JOB

  2. Recherchez le paramètre de parallélisme dans la configuration renvoyée.