Configurer les limites de processeur pour les jobs

Cette page explique comment spécifier le nombre de processeurs virtuels à allouer à chaque instance Cloud Run. Par défaut, les instances de conteneur Cloud Run sont limitées à un processeur virtuel. Vous pouvez augmenter ou diminuer cette valeur comme décrit sur cette page.

Définir et mettre à jour des limites de processeur virtuel

Par défaut, chaque instance est limitée à un processeur virtuel. Vous pouvez remplacer cette valeur par l'une de celles indiquées dans le tableau suivant.

Tableau des processeurs virtuels et de la mémoire

Voici les exigences de mémoire pour les processeurs virtuels :

Processeurs Mémoire requise
1 processeur virtuel 128 Mio à 4 Gio
2 processeurs virtuels 128 Mio à 8 Gio
4 processeurs virtuels 2 à 16 Gio
6 processeurs virtuels 4 à 24 Gio
8 processeurs virtuels 4 à 32 Gio

Les valeurs supérieures à 1 doivent être des entiers.

Nombre maximal de processeurs virtuels

Le nombre maximal de processeurs virtuels que vous pouvez configurer est de 8.

Nombre minimal de processeurs virtuels

Le paramètre minimal de processeur virtuel est de 0,08.

Si vous souhaitez utiliser moins d'un processeur virtuel, vous pouvez sélectionner n'importe quelle valeur comprise entre 0,08 et 1, par incréments de 0,001.

Si vous utilisez moins d'un processeur virtuel, les exigences suivantes sont appliquées :

Paramètre Exigence
Mémoire Un minimum de 0,5 processeur virtuel est nécessaire pour définir une limite de mémoire supérieure à 512 Mio.
Un minimum d'un processeur virtuel est nécessaire pour définir une limite de mémoire supérieure à 1 Gio.
Simultanéité La simultanéité maximale doit être définie sur 1.
Facturation Les paramètres de facturation doivent être définis sur la facturation basée sur les requêtes.
Conteneurs Vous devez déployer plusieurs conteneurs (side-cars).

Considérations liées au coût

Le coût de votre ressource Cloud Run est affecté par sa configuration de processeur et la durée d'activité de votre ressource, entre autres facteurs. Le surprovisionnement de vos ressources peut augmenter vos coûts. Pour déterminer la configuration de processeur la plus adaptée à votre ressource :

  1. Établissez une configuration de référence initiale pour une limite de processeur qui équilibre l'utilisation et les coûts du processeur.
  2. Surveillez vos métriques d'utilisation du processeur dans Cloud Monitoring tout en testant le système sous charge.
  3. Ajustez la configuration de votre processeur si nécessaire.

Si l'utilisation du processeur est constamment faible en période de forte charge, envisagez de réduire l'allocation de processeurs virtuels. Si la latence est élevée, envisagez d'augmenter l'allocation de processeurs virtuels.

Vous pouvez afficher des données récapitulatives sur les coûts, des données d'utilisation et des recommandations d'optimisation des coûts pour les services sur la page Optimisation de Cloud Hub. Pour en savoir plus, consultez les tarifs Cloud Run ou estimez les coûts à l'aide du simulateur de coût.

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 Google Cloud des API, 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 les limites de processeur

Vous devez définir un minimum de un processeur pour une tâche Cloud Run.

Pour spécifier l'utilisation du processeur pour une tâche Cloud Run, procédez comme suit :

Console

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

    Accédez à Cloud Run

  2. Cliquez sur Déployer un conteneur pour remplir la page des paramètres initiaux du job. 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. Cliquez sur l'onglet Général.

    image

    • Sélectionnez l'allocation de processeurs souhaitée dans la liste déroulante. Sélectionnez un nombre de processeurs, 1, 2, 4, 6 ou 8. Les tâches nécessitent au minimum un processeur. (consultez le tableau de la section Définir et mettre à jour des limites de processeur pour connaître les paramètres requis).
  5. Cliquez sur Créer ou Mettre à jour.

gcloud

  1. Mettez à jour les limites de processeur d'une tâche donnée à l'aide de la commande suivante :

    gcloud run jobs update JOB_NAME --cpu CPU

    Remplacer

    • JOB_NAME par le nom de votre tâche
    • CPU par la limite de processeur souhaitée Spécifiez un nombre de processeurs 1, 2, 4, 6 ou 8. Les tâches nécessitent au minimum un processeur. (Consultez le tableau de la section Définir et mettre à jour des limites de processeur pour connaître les paramètres requis.)

    Vous pouvez également définir le processeur lorsque vous créez une tâche à l'aide de la commande suivante :

    gcloud run jobs create JOB_NAME --image IMAGE_URL --cpu CPU

    Remplacer

    • JOB_NAME par le nom de votre job.
    • IMAGE_URL : référence à l' image de conteneur, par exemple us-docker.pkg.dev/cloudrun/container/job:latest.
    • CPU par la limite de processeur souhaitée Spécifiez un nombre de processeurs 1, 2, 4, 6 ou 8. Les tâches nécessitent au minimum un processeur. (Consultez le tableau de la section Définir et mettre à jour des limites de processeur pour connaître les paramètres requis.)

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_NAME --format export > job.yaml
  2. Mettez à jour l'attribut cpu :

    apiVersion: run.googleapis.com/v1
    kind: Job
    metadata:
      name: JOB
    spec:
      template:
        spec:
          template:
            spec:
              containers:
              - image: IMAGE
              resources:
                limits:
                  cpu: CPU

    Remplacez CPU par la limite de processeur souhaitée. Spécifiez un nombre de processeurs 1, 2, 4, 6 ou 8. Les tâches nécessitent au minimum un processeur. (Consultez le tableau de la section Définir et mettre à jour des limites de processeur pour connaître les paramètres requis.)

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

  3. Mettez à jour la configuration de job existante :

    gcloud run jobs replace job.yaml

Terraform

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

Ajoutez les éléments suivants à une google_cloud_run_v2_job ressource dans votre configuration Terraform :

  resource "google_cloud_run_v2_job" "default" {
    name     = "cloudrun-job"
    location = "REGION"
    deletion_protection = false

    template {
      template {
        containers {
          image = "us-docker.pkg.dev/cloudrun/container/job"
          resources {
            limits = {
              cpu    = "CPU"
            }
          }
        }
      }
    }
  }

Remplacez :

  • REGION par la Google Cloud région. Exemple : europe-west1.
  • CPU par la limite de mémoire requise pour votre service. Spécifiez un nombre de processeurs 1, 2, 4, 6 ou 8. Les tâches nécessitent au minimum un processeur. (Consultez le tableau de la section Définir et mettre à jour des limites de processeur pour connaître les paramètres requis.)

Afficher les paramètres du processeur

Pour afficher les paramètres actuels du processeur de votre tâche Cloud Run, procédez comme suit :

Console

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

    Accéder aux jobs Cloud Run

  2. Cliquez sur le job qui vous intéresse pour ouvrir la page Informations sur le job.

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

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

gcloud

  1. Exécutez la commande suivante :

    gcloud run jobs describe JOB_NAME
  2. Recherchez le paramètre de processeur dans la configuration renvoyée.