Migrasi traffic mengalihkan pemilihan rute permintaan antar-versi dalam layanan aplikasi Anda, sehingga memindahkan traffic dari satu atau beberapa versi ke satu versi baru.
Untuk mengetahui informasi tentang cara membagi traffic antara dua versi aplikasi atau lebih, lihat Pemisahan Traffic.
Sebelum memulai
Sebelum Anda dapat mengonfigurasi traffic ke versi tertentu, pastikan akun pengguna Anda menyertakan hak istimewa yang diperlukan.
Memigrasikan traffic secara bertahap
Anda dapat memilih untuk merutekan permintaan ke versi target, baik secara bertahap maupun langsung.
Secara default, warmup request dinonaktifkan dan traffic dimigrasikan langsung ke suatu versi. Anda juga dapat memilih untuk menonaktifkan warmup request jika ingin traffic langsung dimigrasikan ke suatu versi.
Jika Anda langsung memigrasikan traffic ke versi baru tanpa instance yang dijalankan, Anda akan mengalami lonjakan latensi untuk permintaan pemuatan. Men-deploy versi baru dengan nama yang sama dengan versi yang sudah ada akan menyebabkan migrasi traffic secara langsung. Semua instance versi lama akan segera dinonaktifkan. Akan ada lonjakan latensi karena permintaan pemuatan untuk versi baru.
Jika warmup request diaktifkan, Anda dapat memigrasikan traffic antar-versi yang berada di lingkungan yang berbeda hanya dengan menentukan untuk langsung memigrasikan traffic.
Menambahkan warmup request ke aplikasi Anda
Jika warmup request diaktifkan, traffic akan dimigrasikan secara bertahap dengan terlebih dahulu mengirimkan warmup request ke instance baru sebelum instance tersebut menerima permintaan pengguna apa pun. Warmup request meningkatkan waktu respons pengguna dengan memungkinkan versi yang saat ini menerima traffic untuk menangani permintaan tersebut, tetapi migrasi traffic ke versi baru dapat memerlukan waktu singkat saat instance baru dibuat.
Jika warmup request tidak diaktifkan, permintaan pengguna akan dikirim ke instance baru tersebut sebelum dibuat. Karena penundaan yang disebabkan oleh pembuatan instance baru dan pemuatan kode aplikasi, latensi dapat terjadi pada respons pengguna tersebut.
Untuk semua runtime kecuali Java, guna menghindari latensi dan mengaktifkan warmup request, sertakan
elemen inbound_services
dalam file konfigurasi Anda sebelum men-deploy
aplikasi ke App Engine.
Misalnya, Anda menyertakan baris berikut dalam file app.yaml
sebelum men-deploy-nya ke App Engine:
inbound_services:
- warmup
Untuk detail selengkapnya tentang cara mengaktifkan warmup request, lihat Mengonfigurasi warmup request untuk meningkatkan performa.
Memigrasikan traffic ke versi baru
Konsol
Untuk memigrasikan traffic di Konsol Google Cloud, buka halaman Versions:
- Pilih versi mana yang 100% traffic-nya ingin Anda migrasikan.
- Klik Migrate traffic.
- Opsional: Saat warmup request diaktifkan, traffic Anda akan dimigrasikan secara bertahap. Untuk segera memigrasikan traffic, pilih opsi di bagian Show advanced options.
gcloud
Setelah menginstal Google Cloud CLI, Anda menjalankan perintah gcloud
app services set-traffic
untuk memigrasikan 100% traffic ke satu versi. Contoh:
-
Untuk segera memigrasikan traffic:
gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1
-
Untuk memigrasikan traffic secara bertahap, sertakan flag
--migrate
opsional:gcloud app services set-traffic [MY_SERVICE] --splits [MY_VERSION]=1 --migrate
API
Untuk memigrasikan traffic secara terprogram, Anda dapat menggunakan Admin API. Baca artikel Memigrasikan dan Memisahkan Traffic untuk mengetahui detailnya.