Scaling manuel

Cette page explique comment effectuer un scaling manuel de votre service. Elle fournit également des instructions pour un cas d'utilisation courant : modifier le nombre d'instances en fonction d'une programmation à l'aide de jobs Cloud Scheduler et de l'API Cloud Run Admin.

Présentation

Le scaling manuel vous permet de définir un nombre spécifique d'instances, quels que soient le trafic ou l'utilisation, et sans avoir à redéployer. Vous pouvez ainsi écrire votre propre logique de scaling à l'aide d'un système externe. Pour obtenir un exemple, consultez la section Scaling basé sur une programmation.

Par défaut, Cloud Run effectue automatiquement un scaling à la hausse jusqu'à un nombre maximal d'instances spécifié ou par défaut, en fonction du trafic, du processeur ou de vos propres cibles d'utilisation personnalisées du processeur ou de la simultanéité. Toutefois, dans certains cas d'utilisation, vous pouvez définir un nombre spécifique d'instances à l'aide du scaling manuel.

Paramètres minimaux et maximaux au niveau de la révision et scaling manuel

Si vous définissez votre service sur le scaling manuel, tous les paramètres minimaux au niveau de la révision et maximaux d'instance sont ignorés.

Répartition du trafic pour le scaling manuel

La liste suivante décrit comment les instances sont allouées lors de la répartition du trafic dans le cadre du scaling manuel. Cela inclut le comportement des révisions avec uniquement des tags de trafic.

• Lors d'une répartition du trafic, chaque révision reçoit des instances proportionnellement, en fonction de la répartition du trafic, comme pour la répartition du trafic avec un nombre minimal d'instances au niveau du service.

• Si le nombre de révisions recevant du trafic dépasse le nombre d'instances manuelles, certaines révisions n'auront aucune instance. Le trafic envoyé à ces révisions générera la même erreur que si les révisions étaient désactivées.

• Pour toutes les révisions recevant du trafic dans une répartition du trafic, tous les paramètres minimaux et maximaux d'instance au niveau de la révision sont désactivés.

• Si une révision est active uniquement en raison de tags de trafic :

  • Si le nombre minimal d'instances au niveau de la révision est défini, le nombre d'instances spécifié démarre, mais n'est pas comptabilisé dans le nombre total d'instances manuelles du service. La révision n'effectue pas d'autoscaling.
  • Si le nombre minimal d'instances au niveau de la révision n'est pas défini, la révision effectue un scaling à la hausse jusqu'à une instance au maximum, en réponse au trafic envoyé à l'URL du tag.

Comportement de facturation avec le scaling manuel

Lorsque vous utilisez le scaling manuel, le comportement de facturation est semblable à celui de la fonctionnalité d'instances minimales lorsque vous utilisez la fonctionnalité d'instances minimales.

Autrement dit, avec le scaling manuel et la facturation basée sur les instances, les instances inactives mises à l'échelle manuellement sont facturées en tant qu'instances actives.

Si vous utilisez le scaling manuel avec la facturation basée sur les requêtes, les instances inactives mises à l'échelle manuellement sont facturées en tant qu'instances minimales inactives. Pour obtenir des informations complètes sur la facturation, consultez la page des tarifs.

Rôles requis

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

• Développeur Cloud Run (roles/run.developer) sur le service Cloud Run
• Utilisateur du compte de service (roles/iam.serviceAccountUser) sur l'identité du service
• Lecteur Artifact Registry (roles/artifactregistry.reader) sur le dépôt Artifact Registry de l'image de conteneur déployée (le cas échéant)

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 service Cloud Run communique avec Google Cloud des API, telles que les 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 manuel

Vous pouvez configurer le mode de scaling à l'aide de la Google Cloud console, de Google Cloud CLI, d'un fichier YAML ou d'une API lorsque vous créez un service ou mettez à jour une révision :

gcloud run deploy SERVICE \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

gcloud run services update SERVICE \
   --scaling=INSTANCE_COUNT

    curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    -X PATCH \
    -d '{"scaling":{"manualInstanceCount":MANUAL_INSTANCE_COUNT }}' \
    https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.manualInstanceCount

      curl -H "Content-Type: application/json" \
      -H "Authorization: Bearer ACCESS_TOKEN" \
      -X PATCH \
      -d '{"launchStage":"BETA","scaling":{"scalingMode": "AUTOMATIC","manualInstanceCount":null}}' \
      https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=launchStage,scaling.scalingMode,scaling.manualInstanceCount

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE_NAME"
  location = "REGION"

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

Afficher la configuration de scaling de votre service

Pour afficher les instances de configuration de scaling de votre service Cloud Run :

gcloud run services describe SERVICE

gcloud run services describe SERVICE --format export > service.yaml

Désactiver un service

Lorsque vous désactivez un service, toutes les requêtes en cours de traitement peuvent se terminer. Toutefois, toutes les requêtes ultérieures envoyées à l'URL du service échoueront avec une erreur Service unavailable ou Service disabled.

Les requêtes adressées aux révisions de service qui ne sont actives qu'en raison de tags de trafic ne sont pas affectées, car ces révisions ne sont pas désactivées.

Pour désactiver un service, définissez le scaling sur zéro. Vous pouvez désactiver un service à l'aide de la Google Cloud console, de Google Cloud CLI, d'un fichier YAML ou d'une API :

gcloud run services update SERVICE --scaling=0

    curl -H "Content-Type: application/json" \
    -H "Authorization: Bearer ACCESS_TOKEN" \
    -X PATCH \
    -d '{"scaling":{"manualInstanceCount":0 }}' \
    https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/services/SERVICE?update_mask=scaling.manualInstanceCount

resource "google_cloud_run_v2_service" "default" {
  name     = "SERVICE_NAME"
  location = "REGION"

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

Exemple de scaling basé sur une programmation

Un cas d'utilisation courant du scaling manuel consiste à modifier le nombre d'instances en fonction d'une programmation prédéfinie. Dans cet exemple, nous utilisons Cloud Scheduler pour planifier deux jobs, chacun appelant l'API Cloud Run Admin afin de mettre à l'échelle le nombre d'instances. Le premier job Cloud Scheduler définit le service sur le scaling manuel à un nombre spécifié d'instances pendant les horaires d'ouverture (de 9h à 17h, du lundi au vendredi). Le deuxième job définit le service sur le scaling à la baisse à un nombre spécifié d'instances en dehors des heures de bureau.

Dans cet exemple, nous utilisons le guide de démarrage rapide de Cloud Run par souci de simplicité, mais vous pouvez utiliser le service de votre choix.

Pour configurer le scaling manuel basé sur une programmation :

1. Déployez votre service à l'aide de la commande suivante :

   gcloud run deploy SERVICE \
      --image=us-docker.pkg.dev/cloudrun/container/hello \
      --region=REGION \
      --project PROJECT_ID

   Remplacez les éléments suivants :

   • SERVICE : nom du service Cloud Run.
   • REGION : région dans laquelle le service Cloud Run est déployé.
   • PROJECT_ID : ID du Google Cloud projet.

2. Configurez votre service pour le scaling manuel à 10 instances à l'aide de la commande suivante :

   gcloud run services update SERVICE \
      --region=REGION \
      --scaling=10

3. Créez un job Cloud Scheduler qui effectue manuellement un scaling à un nombre spécifié d'instances de service pendant les horaires d'ouverture :

   gcloud scheduler jobs create http hello-start-instances \
     --location=REGION \
     --schedule="0 9 * * MON-FRI" \
     --time-zone=America/Los_Angeles \
     --uri=https://run.googleapis.com/v2/projects/PROJECT_ID/
     locations/REGION/services/hello?update_mask=launchStage,scaling.manualInstanceCount \
     --headers=Content-Type=application/json,X-HTTP-Method-Override=PATCH \
     --http-method=PUT \
     --message-body='{"scaling":{"manualInstanceCount":INSTANCE_COUNT}}' \
     --oauth-service-account-email=PROJECT_NUMBER-compute@developer.gserviceaccount.com

   Remplacez les éléments suivants :

   • REGION : région dans laquelle le service Cloud Run est déployé.
   • PROJECT_ID : ID du Google Cloud projet.
   • INSTANCE_COUNT : nombre d'instances que vous souhaitez mettre à l'échelle, par exemple 10.
   • PROJECT_NUMBER : numéro du Google Cloud projet.

   Cette commande crée un job Cloud Scheduler qui effectue un appel HTTP à l'API Cloud Run Admin, en définissant le nombre d'instances sur le nombre que vous spécifiez. L'exemple utilise le compte de service Compute Engine par défaut PROJECT_NUMBER-compute@developer.gserviceaccount.com pour les jobs Cloud Scheduler. Vous pouvez utiliser n'importe quel compte de service disposant des autorisations nécessaires pour mettre à jour les services Cloud Run.

4. Créez un job Cloud Scheduler qui réduit manuellement le nombre d'instances de service en dehors des heures de bureau :

   gcloud scheduler jobs create http hello-stop-instances \
     --location=REGION \
     --schedule="0 17 * * MON-FRI" \
     --time-zone=America/Los_Angeles \
     --uri=https://run.googleapis.com/v2/projects/PROJECT_ID/
     locations/REGION/services/hello?update_mask=launchStage,scaling.manualInstanceCount \
     --headers=Content-Type=application/json,X-HTTP-Method-Override=PATCH \
     --http-method=PUT \
     --message-body='{"scaling":{"manualInstanceCount":INSTANCE_COUNT}}' \
     --oauth-service-account-email=PROJECT_NUMBER-compute@developer.gserviceaccount.com

   Remplacez les éléments suivants :

   • REGION : région dans laquelle le service Cloud Run est déployé.
   • PROJECT_ID : ID du Google Cloud projet.
   • INSTANCE_COUNT : nombre d'instances que vous souhaitez mettre à l'échelle. Pour désactiver le service, définissez cette valeur sur 0.
   • PROJECT_NUMBER : numéro du Google Cloud projet.

   Cette commande crée un job Cloud Scheduler qui effectue un appel HTTP à l'API Cloud Run Admin, en définissant les instances de scaling manuel sur le nombre d'instances que vous avez spécifié. Définir les instances sur zéro désactive le service, mais pas les jobs Cloud Scheduler. Ces jobs continuent de s'exécuter et réinitialisent (et réactivent) le service à un nombre d'instances plus élevé comme prévu.