Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La migración de tráfico cambia la ruta de la solicitud entre las versiones de un servicio para tu aplicación y mueve el tráfico desde una o más versiones a una única versión nueva.
Para obtener más información sobre cómo dividir el tráfico entre dos o más versiones de tu aplicación, consulta División del tráfico.
Antes de comenzar
Antes de configurar el tráfico hacia una versión, asegúrate de que tu cuenta de usuario tenga los privilegios necesarios.
Cómo migrar el tráfico de manera gradual
En el entorno estándar, puedes elegir enrutar solicitudes hacia la versión objetivo, ya sea de manera gradual o inmediata.
De manera predeterminada, las solicitudes de preparación están habilitadas y todo el tráfico migra de manera gradual hacia una versión.
Puedes inhabilitar las solicitudes de preparación si quieres que el tráfico migre de manera inmediata hacia una versión. Si migras el tráfico de manera inmediata a una versión nueva sin ninguna instancia en ejecución, experimentarás un pico de latencia en las solicitudes de carga.
La implementación de una versión nueva con el mismo nombre que una versión existente da como resultado una migración inmediata del tráfico. Todas las instancias de la versión anterior se cierran de inmediato. Habrá un pico de latencia debido a las solicitudes de carga de la versión nueva.
Si las solicitudes de preparación están habilitadas, puedes migrar el tráfico entre versiones que residan en entornos distintos con solo especificar que el tráfico migre instantáneamente.
Agregar solicitudes de preparación a tu aplicación
Cuando las solicitudes de preparación están habilitadas, el tráfico migra de manera gradual enviando primero una solicitud de preparación a las instancias nuevas antes de que estas reciban solicitudes de usuario. Las solicitudes de preparación mejoran el tiempo de respuesta del usuario al permitir que la versión que recibe el tráfico maneje esas solicitudes, pero la migración del tráfico hacia la versión nueva puede demorar un poco mientras se crean las instancias nuevas.
Cuando las solicitudes de preparación no están habilitadas, las solicitudes de usuario se envían a las instancias nuevas antes de que se creen. Debido a la demora que genera la creación de instancias nuevas y la carga del código de la aplicación, esas respuestas del usuario pueden experimentar latencia.
Selecciona la versión a la que deseas migrar todo el tráfico.
Haz clic en Migrar tráfico.
Opcional: Cuando las solicitudes de preparación están habilitadas, tu tráfico migra de manera gradual. Para migrar el tráfico de manera inmediata, selecciona la opción en la sección Mostrar opciones avanzadas.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 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."]]
