[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC):2025-08-20。"],[[["\u003cp\u003eTraffic migration redirects requests from one or more existing application versions to a single, new version.\u003c/p\u003e\n"],["\u003cp\u003eIn the standard environment, traffic migration can be immediate by default or gradual if warmup requests are enabled.\u003c/p\u003e\n"],["\u003cp\u003eImmediate traffic migration can lead to latency spikes due to the need to create new instances and load application code.\u003c/p\u003e\n"],["\u003cp\u003eEnabling warmup requests allows for a gradual traffic migration by sending warmup requests to new instances before user requests, reducing latency.\u003c/p\u003e\n"],["\u003cp\u003eTraffic migration to versions running in the flexible environment must be done immediately, as gradual migration is not supported there.\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/python/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/python/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 immediately\nor gradually.\n\nBy default, [warmup requests](/appengine/docs/legacy/standard/python/warmup-requests)\nare disabled and traffic is migrated immediately to a\nversion.\n\nYou can also choose to enable\nwarmup requests if you want the traffic\ngradually 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.\nTo avoid latency and enable warmup requests, include the `inbound_services` element in your configuration file before you deploy your application to App Engine.\n\n\u003cbr /\u003e\n\nFor example, you include the following in your\n`app.yaml` file before deploying it to App Engine: \n\n inbound_services:\n - warmup\n\nFor complete details about enabling warmup requests, see\n[Configuring Warmup Requests to Improve Performance](/appengine/docs/legacy/standard/python/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."]]