Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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 de router les requêtes vers la version cible, de manière progressive ou immédiate.
Par défaut, les requêtes de préchauffage sont activées et le trafic est immédiatement migré vers une autre version.
Vous pouvez également choisir de désactiver les requêtes de préchauffage si vous souhaitez que le trafic soit immédiatement migré vers une version. Si vous migrez immédiatement le trafic vers une nouvelle version sans aucune instance en cours d'exécution, le temps de latence du chargement des requêtes augmente.
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 nouvelles instances et le chargement du code de l'application peut entraîner une certaine latence dans les réponses renvoyées aux utilisateurs.
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.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/04/21 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/04/21 (UTC)."],[[["\u003cp\u003eTraffic migration redirects all requests from one or more existing application versions to a single, designated new version.\u003c/p\u003e\n"],["\u003cp\u003eIn the standard environment, traffic migration can occur gradually, with warmup requests enabled, or immediately, without them, while the flexible environment only supports immediate migration.\u003c/p\u003e\n"],["\u003cp\u003eDeploying a new version with the same name as the current version will immediately migrate traffic to the new version and shut down all instances of the old version.\u003c/p\u003e\n"],["\u003cp\u003eWarmup requests are used for gradual migration, ensuring new instances are ready before user requests are sent to them, thereby reducing potential latency.\u003c/p\u003e\n"],["\u003cp\u003eTraffic migration can be managed through the Google Cloud console, the \u003ccode\u003egcloud\u003c/code\u003e command-line tool, or programmatically via the Admin API.\u003c/p\u003e\n"]]],[],null,["# Migrating Traffic\n\nTraffic migration switches the request routing between the versions within a\nservice of your application, moving traffic from one or more versions to a\nsingle new version.\n\nFor information about splitting traffic between two or more versions of your\napp, see [Traffic Splitting](/appengine/docs/legacy/standard/java/splitting-traffic).\n\nBefore you begin\n----------------\n\nBefore you can configure traffic to a version, ensure that your user account\nincludes the [required privileges](/appengine/docs/legacy/standard/java/access-control#basic_roles).\n\nMigrating traffic gradually\n---------------------------\n\nIn the standard environment, you can choose to route requests to the target\nversion, either gradually\nor immediately.\n\nBy default, [warmup requests](/appengine/docs/legacy/standard/java/warmup-requests)\nare enabled and all traffic is gradually\nmigrated to a\nversion.\n\nYou can also choose to disable\nwarmup requests if you want the traffic\nimmediately migrated to a\nversion. If you immediately migrate traffic to a new version without any running\ninstances then you will experience a spike in latency for loading requests.\nDeploying a new version with the same name as an existing version causes an\nimmediate traffic migration. All instances of the old version are immediately\nshut down. There will be a latency spike due to loading requests for the new\nversion.\n| **Note:** Gradual traffic migration traffic between versions running in the flexible environment is not supported. You must migrate traffic immediately to versions that are running in the flexible environment.\n\nIf warmup requests are enabled, you can migrate traffic between versions that\nreside in different environments only by specifying to migrate traffic\nimmediately.\n\n### Adding warmup requests to your application\n\nWhen warmup requests are enabled, traffic is migrated gradually by first sending\na *warmup request* to new instances before those instances receive any user\nrequests. Warmup requests improve user response time by allowing the version\ncurrently receiving traffic to handle those requests but the traffic migration\nto the new version can take a short amount of time while the new instances are\ncreated.\n\nWhen warmup requests are not enabled, user requests are sent to those new\ninstances before they have been created. Due to the delay caused by creating\nthe new instances and loading application code, latency can occur for those user\nresponses.\n\nFor complete details about enabling warmup requests, see\n[Configuring Warmup Requests to Improve Performance](/appengine/docs/legacy/standard/java/configuring-warmup-requests).\n\n\nMigrating traffic to a new version\n----------------------------------\n\n### Console\n\nTo migrate traffic in the Google Cloud console, go to the Versions page:\n\n[Go to the Versions page](https://console.cloud.google.com/appengine/versions)\n\n1. Select the version to which you want to migrate 100% of the traffic.\n2. Click **Migrate traffic**.\n3. Optional: When warmup requests are enabled your traffic is migrated gradually. To migrate traffic immediately, select the option under the **Show advanced options** section.\n\n### gcloud\n\nAfter installing the [Google Cloud CLI](/sdk/docs), you run the [`gcloud\napp services set-traffic`](/sdk/gcloud/reference/app/services/set-traffic)\ncommand to migrate 100% of traffic to a single version. For example:\n\n- To migrate traffic immediately: \n\n ```bash\n gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1\n ```\n- To gradually migrate traffic, you include the optional `--migrate` flag: \n\n ```bash\n gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1 --migrate\n ```\n\n### API\n\nTo programmatically migrate traffic, you can use the Admin API,\nsee [Migrating and Splitting\nTraffic](/appengine/docs/admin-api/migrating-splitting-traffic) for details."]]
