La migrazione del traffico trasferisce il routing delle richieste tra le versioni all'interno di un servizio dell'applicazione, spostando il traffico da una o più versioni a un'unica nuova versione.
Per informazioni sulla suddivisione del traffico tra due o più versioni dell'app, consulta la sezione Suddivisione del traffico.
Prima di iniziare
Prima di poter configurare il traffico verso una versione, assicurati che il tuo account utente includa i privilegi necessari.
Migrazione graduale del traffico
Nell'ambiente standard, puoi scegliere di indirizzare le richieste alla versione di destinazione, immediatamente o gradualmente.
Per impostazione predefinita, le richieste di preparazione sono disattivate e il traffico viene migrato immediatamente a una versione.
Puoi anche scegliere di abilitare le richieste di preparazione se vuoi che il traffico venga migrato gradualmente a una versione. Se esegui immediatamente la migrazione del traffico a una nuova versione senza istanze in esecuzione, noterai un picco di latenza per il caricamento delle richieste. Il deployment di una nuova versione con lo stesso nome di una versione esistente provoca una migrazione immediata del traffico. Tutte le istanze della vecchia versione vengono arrestate immediatamente. Ci sarà un picco di latenza dovuto alle richieste di caricamento della nuova versione.
Se le richieste di warmup sono abilitate, puoi eseguire la migrazione del traffico tra versioni che risiedono in ambienti diversi solo specificando la migrazione immediata del traffico.
Aggiunta di richieste di warmup all'applicazione
Quando le richieste di riscaldamento sono abilitate, la migrazione del traffico viene eseguita gradualmente inviando una richiesta di preparazione alle nuove istanze prima che queste ricevano le richieste degli utenti. Le richieste di riscaldamento migliorano il tempo di risposta degli utenti consentendo alla versione che attualmente riceve traffico di gestire tali richieste, ma la migrazione del traffico alla nuova versione può richiedere un breve periodo di tempo durante la creazione delle nuove istanze.
Quando le richieste di riscaldamento non sono abilitate, le richieste degli utenti vengono inviate alle nuove istanze prima che vengano create. A causa del ritardo causato dalla creazione delle nuove istanze e dal caricamento del codice dell'applicazione, può verificarsi una latenza per le risposte degli utenti.
Per evitare latenza e abilitare le richieste di riscaldamento, includi l'elementoinbound_services nel file di configurazione prima di eseguire il deployment
dell'applicazione in App Engine.
Ad esempio, includi quanto segue nel file app.yaml prima di eseguirne il deployment in App Engine:
inbound_services:
- warmup
Per informazioni dettagliate sull'abilitazione delle richieste di warmup, consulta Configurazione delle richieste di riscaldamento per migliorare le prestazioni.
Migrazione del traffico a una nuova versione
Console
Per eseguire la migrazione del traffico nella console Google Cloud, vai alla pagina Versioni:
- Seleziona la versione verso cui vuoi eseguire la migrazione del 100% del traffico.
- Fai clic su Esegui la migrazione del traffico.
- (Facoltativo) Quando le richieste di warmup sono abilitate, la migrazione del traffico viene eseguita gradualmente. Per eseguire subito la migrazione del traffico, seleziona l'opzione nella sezione Mostra opzioni avanzate.
gcloud
Dopo aver installato Google Cloud CLI, esegui il comando gcloud
app services set-traffic per eseguire la migrazione del 100% del traffico a una singola versione. Ad esempio:
-
Per eseguire subito la migrazione del traffico:
gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1
-
Per eseguire la migrazione graduale del traffico, includi il flag
facoltativo
--migrate:gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1 --migrate
API
Per eseguire la migrazione del traffico in modo programmatico, puoi utilizzare l'API Admin. Consulta Migrazione e suddivisione del traffico per i dettagli.