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 non liées aux requêtes. 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 le fractionnement d'instances.

Cloud Run vous permet d'indiquer les révisions qui reçoivent des instances et de spécifier 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 de l'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 se poursuivent jusqu'à la fin. Les requêtes en cours ne sont pas supprimées. Cloud Run peut les rediriger 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 les 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 répartition des instances. Pour revenir à la dernière révision sans fractionnement des instances, envoyez toutes les instances vers la dernière révision.

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer les pools de nœuds de calcul et les révisions de pools de nœuds de calcul Cloud Run, 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 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.

Effectuer un rollback vers une révision antérieure

Pour revenir à une révision précédente, utilisez la console Google Cloud ou la Google Cloud CLI :

Console

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

    Accédez à Cloud Run

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

  3. Cliquez sur l'onglet Révisions pour afficher la liste des révisions en cours pour ce pool de nœuds de calcul.

  4. Cliquez sur Gérer les divisions d'instances pour afficher le formulaire de gestion des instances. Cloud Run liste la dernière révision diffusée. Dans le formulaire, configurez les informations suivantes :

    1. Cliquez sur Ajouter une révision, puis sélectionnez une révision précédente dans la liste déroulante.
    2. Définissez le pourcentage d'instances de la 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 Enregistrer.

gcloud

Spécifiez les révisions auxquelles revenir 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 console Google Cloud ou Google Cloud CLI :

Lorsque vous répartissez les 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 doit être supérieur au nombre de répartitions d'instances servant la charge de travail.

Console

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

    Accédez à Cloud Run

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

  3. Cliquez sur l'onglet Révisions pour afficher la liste des révisions en cours pour ce pool de nœuds de calcul.

  4. Cliquez sur Gérer les divisions d'instances pour afficher le formulaire de gestion des instances. Cloud Run liste la dernière révision diffusée. Dans le formulaire, configurez les informations suivantes :

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

    2. Cliquez sur 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 Ajouter une révision, sélectionnez une autre révision, puis définissez son pourcentage.

    4. Cliquez sur Enregistrer.

gcloud

Spécifiez les révisions et le pourcentage d'instances en exécutant la commande suivante. Attribuez des instances à 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 séparés par une virgule :

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

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

Attribuer 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 révisions ultérieures, en remplaçant toute répartition d'instances établie. Pour allouer 100 % des instances à la dernière révision, exécutez les commandes suivantes :

  • Utilisez l'indicateur --to-latest pour rediriger 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'option --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 aux dernières révisions et aux futures dernières révisions.

Étapes suivantes