Scaling manuel pour les pools de nœuds de calcul

Le scaling manuel vous permet de définir un nombre d'instances spécifique sans nécessiter de redéploiement. Utilisez le scaling manuel lorsque votre charge de travail nécessite un nombre fixe d'instances ou lorsque vous souhaitez contrôler le nombre d'instances à partir de votre propre système.

Pour effectuer un scaling automatique des instances en fonction de l'utilisation du processeur au lieu de définir un nombre d'instances fixe, consultez Configurer l'autoscaling du processeur pour les pools de nœuds de calcul.

Facturation lors de l'utilisation de l'autoscaling manuel

Lorsque vous utilisez le scaling manuel, toutes les instances que vous avez demandées sont facturées en tant qu'instances actives, même si elles sont inactives. Pour en savoir plus sur la facturation, consultez la page des tarifs.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer et déployer des pools de nœuds de calcul 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 pool de nœuds de calcul 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 scaling

La modification du mode de scaling ou du nombre d'instances manuel ne crée pas de révision.

Pour configurer le mode de scaling, utilisez la console Google Cloud , la Google Cloud CLI, YAML, Terraform ou l'API REST :

Console

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

    Accédez à Cloud Run

  2. Si vous configurez un nouveau pool de nœuds de calcul, sélectionnez Pools de nœuds de calcul dans le menu, puis cliquez sur Déployer un conteneur. Si vous configurez un pool de nœuds de calcul existant, cliquez sur celui-ci pour afficher son volet Détails, puis sur l'icône en forme de crayon à côté de Scaling (Scaling) en haut à droite du panneau Détails.

  3. Recherchez le formulaire Scaling (pour un nouveau pool de nœuds de calcul) ou le formulaire Modifier le scaling pour un pool de nœuds de calcul existant.

    image

  4. Dans le champ Nombre d'instances, spécifiez le nombre d'instances de conteneur pour le pool de nœuds de calcul.

  5. Terminez la spécification.

  6. Cliquez sur Créer pour un nouveau pool de nœuds de calcul ou sur Enregistrer pour un pool de nœuds de calcul existant.

gcloud

  • Pour spécifier l'autoscaling manuel pour un nouveau pool de nœuds de calcul, exécutez la commande suivante avec l'option --scaling :
gcloud beta run worker-pools deploy WORKER_POOL \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

Remplacez les éléments suivants :

  • WORKER_POOL : nom de votre pool de nœuds de calcul.
  • INSTANCE_COUNT : nombre d'instances du pool de nœuds de calcul. Cela définit le pool de nœuds de calcul sur le scaling manuel. Spécifiez la valeur 0 pour désactiver le pool de nœuds de calcul.
  • IMAGE_URL : référence à l'image de conteneur contenant le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

  • Pour spécifier le scaling manuel d'un pool de nœuds de calcul existant, exécutez la commande suivante avec l'option --scaling :

gcloud beta run worker-pools update WORKER_POOL \
    --scaling=INSTANCE_COUNT

Remplacez les éléments suivants :

  • WORKER_POOL : nom de votre pool de nœuds de calcul.
  • INSTANCE_COUNT : nombre d'instances du pool de nœuds de calcul.

YAML

  1. Si vous créez un pool de nœuds de calcul, ignorez cette étape. Si vous mettez à jour un pool de nœuds de calcul existant, téléchargez sa configuration YAML :

    gcloud run worker-pools describe WORKER_POOL --format export > worker-pool.yaml
  2. Définissez scalingMode sur manual et spécifiez manualInstanceCount :

    apiVersion: run.googleapis.com/v1
    kind: WorkerPool
    metadata:
    name: WORKER_POOL
    annotations:
      run.googleapis.com/scalingMode: manual
      run.googleapis.com/manualInstanceCount: "INSTANCE_COUNT"

    Remplacez les éléments suivants :

    • WORKER_POOL : nom de votre pool de nœuds de calcul Cloud Run.
    • INSTANCE_COUNT : nombre d'instances que vous faites évoluer manuellement pour le pool de nœuds de calcul. Spécifiez la valeur 0 pour désactiver le pool de nœuds de calcul.
  3. Créez ou mettez à jour le pool de nœuds de calcul à l'aide de la commande suivante :

    gcloud run worker-pools replace worker-pool.yaml

    Par défaut, la commande gcloud run worker-pools replace utilise le fichier worker-pool.yaml s'il est présent.

Terraform

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

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "INSTANCE_COUNT"
  }
}

Remplacez les éléments suivants :

  • WORKER_POOL : nom du pool de nœuds de calcul.
  • REGION : région Google Cloud , par exemple europe-west1.
  • IMAGE_URL : référence à l'image de conteneur contenant le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • INSTANCE_COUNT : nombre d'instances du pool de nœuds de calcul. Cela définit le pool de nœuds de calcul sur le scaling manuel. Spécifiez la valeur 0 pour désactiver le pool de nœuds de calcul.

API REST

Pour mettre à jour le nombre d'instances d'un pool de nœuds de calcul donné, envoyez une requête HTTP PATCH au point de terminaison workerPools.patch de l'API Cloud Run Admin :

curl -H "Content-Type: application/json" \
   -H "Authorization: Bearer ACCESS_TOKEN" \
   -X PATCH \
   -d '{"scaling":{"scalingMode":"MANUAL","manualInstanceCount":INSTANCE_COUNT}}' \
   https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/workerPools/WORKER_POOL?update_mask=scaling.scalingMode,scaling.manualInstanceCount

Remplacez les éléments suivants :

  • ACCESS_TOKEN : jeton d'accès valide pour un compte disposant des autorisations IAM pour mettre à jour un pool de nœuds de calcul. Par exemple, si vous êtes connecté à gcloud, vous pouvez récupérer un jeton d'accès à l'aide de gcloud auth print-access-token. À partir d'une instance de conteneur Cloud Run, vous pouvez récupérer un jeton d'accès via le serveur de métadonnées d'instance de conteneur.
  • INSTANCE_COUNT : nombre d'instances du pool de nœuds de calcul.
  • PROJECT_ID : ID du projet Google Cloud .
  • REGION : région Google Cloud dans laquelle le pool de nœuds de calcul est déployé.
  • WORKER_POOL : nom du pool de nœuds de calcul.

Afficher la configuration de scaling d'un pool de nœuds de calcul

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

    Accédez à Cloud Run

  2. Cliquez sur Pools de nœuds de calcul pour afficher la liste des pools de nœuds de calcul déployés.

  3. Cliquez sur le pool de nœuds de calcul que vous souhaitez examiner pour afficher son volet Détails.

  4. Le paramètre de scaling actuel est affiché au-dessus de la liste des révisions du pool de nœuds de calcul : Scaling : manuel (instances : ).

Désactiver un pool de nœuds de calcul

Pour désactiver un pool de nœuds de calcul, exécutez la commande suivante avec l'option --scaling=0 :

gcloud beta run worker-pools update WORKER_POOL --scaling=0

Remplacez WORKER_POOL par le nom de votre pool de nœuds de calcul.

Étapes suivantes