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.
Pour en savoir plus sur la répartition du trafic entre plusieurs versions de votre application, consultez la page Répartition du trafic.
Avant de commencer
Pour pouvoir configurer la quantité de trafic à migrer vers une version, assurez-vous que votre compte utilisateur dispose des privilèges requis.
Migrer le trafic progressivement
Dans l'environnement standard, vous pouvez choisir d'acheminer les requêtes vers la version cible de manière progressive ou immédiate.
Par défaut, les requêtes de préchauffage sont désactivées, et le trafic est immédiatement migré vers une version.
Vous pouvez également choisir d'activer les requêtes de préchauffage si vous souhaitez que le trafic soit migré progressivement vers une autre version. Si vous migrez immédiatement le trafic vers une nouvelle version sans aucune instance en cours d'exécution, vous constaterez un pic de latence dû aux requêtes de chargement. Le déploiement d'une nouvelle version portant le même nom qu'une version existante entraîne une migration immédiate du trafic. Toutes les instances de l'ancienne version sont immédiatement arrêtées. Vous constaterez un pic de latence dû aux requêtes de chargement liées à la nouvelle version.
Si les requêtes de préchauffage sont activées, vous ne pouvez migrer le trafic entre des versions qui résident dans des environnements différents qu'en spécifiant une migration immédiate.
Ajouter des requêtes de préchauffage à votre application
Si les requêtes de préchauffage sont activées, le trafic est migré progressivement. Pour ce faire, une requête de préchauffage est d'abord envoyée aux nouvelles instances avant que celles-ci ne reçoivent les requêtes des utilisateurs. Les requêtes de préchauffage améliorent le temps de réponse aux utilisateurs en permettant à la version qui reçoit actuellement le trafic de gérer ces requêtes. Toutefois, la migration du trafic vers la nouvelle version peut prendre un certain temps pendant la création des instances.
Si les requêtes de préchauffage ne sont pas activées, les requêtes des utilisateurs sont envoyées aux nouvelles instances avant que celles-ci n'aient été créées. Le délai causé par la création des instances et le chargement du code de l'application peut entraîner une latence des réponses renvoyées aux utilisateurs.
Pour éviter la latence et activer les requêtes de préchauffage, incluez l'élémentinbound_services dans votre fichier de configuration avant de déployer votre application sur App Engine.
Par exemple, incluez les éléments suivants dans le fichier app.yaml avant de le déployer sur App Engine :
inbound_services:
- warmup
Pour en savoir plus sur l'activation des requêtes de préchauffage, consultez la section Configurer des requêtes de préchauffage pour améliorer les performances.
Migrer le trafic vers une nouvelle version
Console
Pour migrer le trafic dans la console Google Cloud, accédez à la page "Versions" :
- Sélectionnez la version vers laquelle vous souhaitez migrer la totalité du trafic.
- Cliquez sur Migrer le trafic.
- (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
--migratefacultatif :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.