全部产品
Search
文档中心

Serverless App Engine:Lakukan rilis canary untuk aplikasi

更新时间:Dec 19, 2025

Jika Anda ingin memperbarui aplikasi yang terdiri dari beberapa instans, Anda dapat meng-upgrade instans aplikasi tersebut ke versi berbeda menggunakan metode rilis canary atau rilis bertahap. Topik ini menjelaskan metode rilis canary serta cara melaksanakan rilis canary dan rollback aplikasi.

Prasyarat

Jumlah instans dalam aplikasi target lebih dari 1.

Latar Belakang

Rilis canary adalah metode penerapan yang digunakan untuk menguji performa versi baru sambil tetap mempertahankan ketersediaan versi asli. Pendekatan ini membantu memastikan stabilitas sistem serta memungkinkan identifikasi dan perbaikan error sesegera mungkin.

Untuk menjaga stabilitas aplikasi, jumlah instans dalam rilis canary tidak boleh melebihi 50% dari total instans aplikasi. Instans sisanya dirilis dalam beberapa batch. Setelah batch pertama selesai dirilis, Anda dapat menentukan apakah akan melanjutkan ke batch berikutnya. Sebelum merilis batch selanjutnya secara manual, Anda dapat mengumpulkan data bisnis dari versi baru untuk memutuskan kelanjutan proses rilis.

Tipe rilis canary berikut ini didukung:

  • Rilis canary berdasarkan rasio traffic: Misalnya, Anda dapat mengarahkan 20% traffic ke versi baru dan 80% ke versi saat ini.

  • Rilis canary berdasarkan konten permintaan: Misalnya, Anda dapat mengarahkan traffic dari permintaan dengan ID pengguna tertentu ke versi baru, sedangkan traffic lainnya tetap ke versi saat ini.

Metode rilis canary menyediakan kontrol traffic yang lebih detail dibandingkan metode rilis bertahap. Untuk informasi selengkapnya tentang rilis bertahap, lihat Lakukan rilis bertahap untuk aplikasi.

Skenario

Misalnya, sebuah aplikasi memiliki 10 instans V1, dan Anda ingin memperbaruinya ke V2. Dalam contoh ini, rilis canary dilakukan pada dua instans, sedangkan delapan instans sisanya dirilis dalam tiga batch. Gambar berikut menggambarkan proses rilis canary tersebut.

image

Prosedur

Peringatan

Setelah menerapkan ulang aplikasi, aplikasi akan dimulai ulang. Untuk mencegah gangguan bisnis atau error tak terduga, disarankan untuk melakukan penerapan selama jam sepi.

  1. Pada halaman SAE Application List, pilih wilayah dan namespace di bagian atas, lalu klik ID aplikasi target untuk membuka halaman detail aplikasi.

  2. Pada halaman Basic Information aplikasi target, klik Deploy Application.

  3. Konfigurasikan parameter penerapan.

    Catatan

    Metode penerapan aplikasi mengikuti metode yang dipilih saat pertama kali menerapkan aplikasi tersebut. Konfigurasikan parameter sesuai metode yang telah ditentukan.

    • Deployment with WAR Packages: Unggah paket WAR lain atau masukkan path paket WAR yang baru diterapkan, lalu konfigurasikan lingkungan runtime dan pengaturan lainnya.

    • Deployment with JAR Packages: Unggah paket JAR lain atau masukkan path paket JAR yang baru diterapkan, lalu konfigurasikan lingkungan runtime dan pengaturan lainnya.

    • Deployment with ZIP Packages: Unggah paket ZIP lain atau masukkan path paket ZIP yang baru diterapkan, lalu konfigurasikan lingkungan runtime dan pengaturan lainnya.

    • Image: Pada bagian Configure Image, klik Modify Image. Di panel Modify Image, pilih repository image atau versi gambar lainnya.

  4. Pada bagian Release Policy Settings, konfigurasikan rilis canary.

    gE6PL2tWNl

    Item Konfigurasi

    Deskripsi

    Release Policy

    Pilih Canary Release (Phased).

    Instances for Canary Release

    Jumlah instans yang akan digunakan untuk rilis canary.

    Remaining Batches After Canary

    Jumlah batch untuk merilis instans yang tersisa setelah rilis canary.

    Minimum Available Instances

    Jumlah minimum instans yang tersedia selama setiap upgrade bergulir.

    • By Number: Masukkan jumlah minimum instans yang tersedia. Jika Anda memilih Use System Recommended Value, jumlah minimum instans yang tersedia diatur menjadi 25% dari jumlah instans yang ada.

    • By Ratio: Masukkan persentase.

    Catatan
    • Pastikan setidaknya satu instans tersedia selama penerapan dan rollback aplikasi untuk menjamin kelangsungan bisnis. Jika nilai diatur ke 0, gangguan bisnis akan terjadi saat aplikasi di-upgrade.

    • Jika Anda menentukan persentase, jumlah minimum instans yang tersedia dibulatkan ke atas ke bilangan bulat terdekat. Misalnya, jika tersedia lima instans dan Anda menentukan 25%, maka jumlah minimum instans yang tersedia adalah 2.

    Enable Layer 7 Traffic Canary Release Rule (Kubernetes Ingress)

    Fitur ini hanya berlaku setelah Anda membuat aturan rilis canary traffic Lapisan 7 (Kubernetes Ingress).

    Enable Canary Release Rule of Microservices (Spring Cloud and Dubbo Applications)

    Fitur ini hanya berlaku setelah Anda membuat aturan rilis canary traffic layanan mikro.

  5. Setelah konfigurasi selesai, klik OK.

  6. Gunakan salah satu metode berikut untuk memverifikasi apakah konfigurasi telah diterapkan:

    • Metode 1: Pada halaman Change Records, lihat detail perubahan dan status rilis aplikasi. Jika semua batch telah dieksekusi, aplikasi telah berhasil di-upgrade.

    • Metode 2: Pada halaman Basic Information, klik tab Instances untuk melihat status instans. Jika kolom Status menampilkan Running, aplikasi telah diterapkan.

Rollback aplikasi

Jika satu atau beberapa instans belum di-upgrade saat menggunakan metode rilis canary atau rilis bertahap, status upgrade aplikasi adalah Executing.

Jika tidak ada respons dari batch rilis pertama karena suatu exception, klik Roll Back Now pada halaman Change Details untuk melakukan rollback instans yang telah di-upgrade ke versi sebelumnya dan memulihkan konfigurasi aplikasi ke kondisi awal sebelum upgrade.

Jika aplikasi gagal di-upgrade akibat exception (misalnya, paket penyebaran tidak tersedia atau pemeriksaan kesehatan gagal) selama proses perubahan, SAE akan menghentikan aplikasi dan melakukan rollback secara otomatis.

Proses upgrade aplikasi di SAE memerlukan waktu sekitar 30 menit. Jika melebihi batas waktu tersebut, SAE akan melaporkan exception timeout dan menghentikan proses perubahan. Dalam kasus ini, Anda harus menghentikan proses rilis secara manual dan melakukan rollback aplikasi melalui halaman Change Details.

Referensi

Tabel berikut menjelaskan operasi yang dapat Anda lakukan pada aplikasi setelah menerapkannya di SAE.

Operasi

Referensi

Operasi manajemen siklus hidup, seperti memperbarui, memulai, menghentikan, dan menghapus aplikasi, serta scaling in atau scaling out instans untuk aplikasi

Manage the lifecycle of an application

Operasi optimasi performa, seperti mengonfigurasi kebijakan auto scaling untuk aplikasi, mengikat instans Server Load Balancer (SLB) ke aplikasi, serta memulai atau menghentikan aplikasi secara batch

Operasi berbasis status aplikasi, seperti mengelola log, mengonfigurasi pengaturan pemantauan, melihat event aplikasi, dan melihat catatan perubahan