Migration du trafic

La migration de trafic bascule le routage des demandes entre les versions d'un service de votre application, en déplaçant le trafic d'une ou de plusieurs versions vers une nouvelle version.

Le trafic est immédiatement migré entre les versions de l'environnement flexible. Contrairement aux versions de l'environnement standard, la migration progressive du trafic n'est pas prise en charge dans l'environnement flexible.

Si vous migrez immédiatement le trafic vers une nouvelle version sans aucune instance en cours d'exécution, votre application connaîtra un pic de latence lors de la création des instances. Vous pouvez éviter ce pic en utilisant l'API d'administration d'App Engine pour fournir suffisamment d'instances de la version de la nouvelle application avant de migrer le trafic.

Pour la nouvelle version, définissez minTotalInstances sur le nombre d'instances nécessaires pour gérer le trafic attendu. Une fois la migration terminée, vous pouvez réinitialiser ce champ afin que l'autoscaling ait lieu en cas de perte de trafic.

Vous pouvez répartir le trafic entre les versions de votre application, augmentant ainsi la quantité de trafic qu'une version reçoit par étapes.

Pour plus d'informations sur la répartition du trafic entre plusieurs versions de votre application, consultez la section Répartition du trafic.

Avant de commencer

Pour pouvoir configurer le trafic vers une version, assurez-vous que votre compte d'utilisateur inclut les privilèges requis.

Migrer le trafic vers une nouvelle version

Console

Pour migrer le trafic dans la console Google Cloud, accédez à la page "Versions" :

Accéder à la page "Versions"

  1. Sélectionnez la version vers laquelle vous souhaitez migrer la totalité du trafic.
  2. Cliquez sur Migrer le trafic.
  3. (Facultatif) Si les requêtes de préchauffage sont activées, le trafic est migré progressivement. Pour procéder à une migration immédiate, sélectionnez l'option correspondante dans la section Afficher les options avancées.

gcloud

Après avoir installé Google Cloud CLI, exécutez la commande gcloud app services set-traffic pour migrer la totalité du trafic vers une seule version. Exemple :

  • Pour migrer le trafic immédiatement :
    gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1
  • Pour migrer le trafic progressivement, incluez l'indicateur --migrate facultatif :
    gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1 --migrate

API

Pour migrer le trafic de manière automatisée, vous pouvez utiliser l'API Admin. Pour en savoir plus, consultez la page Migrer le trafic et le répartir.