Divisions et rollbacks d'instances pour les pools de nœuds de calcul Cloud Run

Les pools de nœuds de calcul gèrent les charges de travail sans requête. Pour les cas d'utilisation qui nécessitent de répartir le travail entre plusieurs révisions, comme le déploiement d'une nouvelle révision, les pools de nœuds de calcul utilisent la division d'instances.

Cloud Run vous permet de spécifier les révisions qui reçoivent des instances et les pourcentages d'allocation d'instances pour chaque révision. Cette fonctionnalité vous permet d'effectuer un rollback vers une révision précédente, de répartir les instances entre plusieurs révisions et d'allouer des instances à la dernière révision. Cette page explique comment utiliser cette fonctionnalité pour gérer l'allocation d'instances à vos révisions Cloud Run.

Les ajustements d'allocation d'instances ne sont pas instantanés. Lorsque vous modifiez l'allocation d'instances pour les révisions, toutes les requêtes en cours de traitement sont menées à terme. Les requêtes en cours de transfert ne sont pas supprimées, et Cloud Run peut les diriger vers une nouvelle révision ou vers une révision précédente pendant la période de transition.

Cycle de vie des divisions d'instances

Si vous répartissez des instances entre plusieurs révisions ou si vous en attribuez à une révision précédente, tous les déploiements ultérieurs utiliseront ce modèle de division d'instances. Pour revenir à l'utilisation de la dernière révision sans division d'instances, envoyez toutes les instances à la dernière révision.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les pools de nœuds de calcul Cloud Run et les révisions de pools de nœuds de calcul, demandez à votre administrateur de vous accorder le rôle IAM Développeur Cloud Run (roles/run.developer) sur votre pool de nœuds de calcul Cloud Run.

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 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.

Effectuer un rollback vers une révision antérieure

Pour effectuer un rollback vers une révision précédente, utilisez la Google Cloud console ou Google Cloud CLI :

Console

  1. Dans la Google Cloud console, accédez aux pools de nœuds de calcul Cloud Run :

    Accédez à Cloud Run

  2. Recherchez le pool de nœuds de calcul dans la liste, puis cliquez dessus.

  3. Cliquez sur l'onglet Revisions (Révisions) pour afficher la liste des révisions actuelles de ce pool de nœuds de calcul.

  4. Cliquez sur Manage instance splits (Gérer les divisions d'instances) pour afficher le formulaire de gestion des instances. Cloud Run affiche la dernière révision diffusée. Dans le formulaire, configurez les détails suivants :

    1. Cliquez sur Add revision (Ajouter une révision), puis utilisez la liste déroulante pour sélectionner une révision précédente.
    2. Définissez le pourcentage d'instances de cette révision précédente sur 100.
    3. Définissez le pourcentage de la dernière révision diffusée sur 0.
    4. Cliquez sur Save (Enregistrer).

gcloud

Spécifiez les révisions vers lesquelles effectuer le rollback en exécutant la commande suivante 

   gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=REVISION=100

Remplacez les éléments suivants :

  • WORKER_POOL : nom du pool de nœuds de calcul.
  • REVISION : nom de la révision vers laquelle vous effectuez le rollback.

Répartir les instances entre plusieurs révisions

Pour répartir les instances entre deux révisions ou plus, utilisez la Google Cloud console ou Google Cloud CLI :

Lorsque vous répartissez des instances entre plusieurs révisions, assurez-vous que le pourcentage total de toutes les révisions est égal à 100 % et que le nombre d'instances manuelles est supérieur au nombre de divisions d'instances diffusant la charge de travail.

Console

  1. Dans la Google Cloud console, accédez aux pools de nœuds de calcul Cloud Run :

    Accédez à Cloud Run

  2. Recherchez le pool de nœuds de calcul dans la liste, puis cliquez dessus.

  3. Cliquez sur l'onglet Revisions (Révisions) pour afficher la liste des révisions actuelles de ce pool de nœuds de calcul.

  4. Cliquez sur Manage instance splits (Gérer les divisions d'instances) pour afficher le formulaire de gestion des instances. Cloud Run affiche la dernière révision diffusée. Dans le formulaire, configurez les détails suivants :

    1. Définissez le pourcentage de la dernière révision diffusée sur la répartition requise (par exemple, réduisez-le de 100 %.).

    2. Cliquez sur Add revision (Ajouter une révision), puis utilisez la liste déroulante pour sélectionner une révision précédente et définir le pourcentage de répartition correspondant.

    3. Pour répartir les instances avec des révisions supplémentaires, cliquez sur Add Revision (Ajouter une révision), et sélectionnez une autre révision, puis définissez son pourcentage.

    4. Cliquez sur Save (Enregistrer).

gcloud

Spécifiez les révisions et le pourcentage d'instances en exécutant la commande suivante commande. Allouez des instances pour chaque révision dans une liste délimitée par des virgules :

   gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=LIST

Remplacez les éléments suivants :

  • WORKER_POOL : nom du pool de nœuds de calcul.

  • LIST : liste de révisions et de pourcentages délimitée par des virgules :

    REVISION1=PERCENTAGE1,REVISION2=PERCENTAGE2,REVISIONn=PERCENTAGEx.

    Par exemple, my-worker-pool-s5sxn=10,my-worker-pool-cp9kw=90.

Allouer des instances à la dernière révision

Lorsque vous déployez une nouvelle révision, vous pouvez allouer 100 % des instances à cette révision et à toutes les suivantes, en remplaçant toute division d'instances établie. Pour allouer 100 % des instances à la dernière révision, exécutez les commandes suivantes :

  • Utilisez l'indicateur --to-latest pour diriger 100 % des instances vers la dernière révision et allouer automatiquement toutes les instances à toute nouvelle révision que vous déployez :

    gcloud beta run worker-pools update-instance-split WORKER_POOL --to-latest

  • Vous pouvez également utiliser l'indicateur --to-revisions avec le mot clé LATEST pour toujours allouer un pourcentage flottant d'instances à la dernière révision lorsque vous en déployez une. Pour définir un pourcentage d'instances qui flottent toujours vers la dernière révision, exécutez la commande suivante :

    gcloud beta run worker-pools update-instance-split WORKER_POOL --to-revisions=LATEST=PERCENTAGE

    Remplacez les éléments suivants :

    • WORKER_POOL : nom du pool de nœuds de calcul.
    • PERCENTAGE : pourcentage d'instances à allouer pour la dernière révision et les suivantes.

Étape suivante