Komponen ack-onepilot secara otomatis memperbarui agen Application Real-Time Monitoring Service (ARMS) di kluster Kubernetes. Jika Anda perlu memvalidasi versi agen baru sebelum peluncuran luas atau mempertahankan versi tertentu demi stabilitas, sematkan (pin) agen ke versi tetap alih-alih menerima pembaruan otomatis.
Pilih metode berdasarkan versi ack-onepilot di kluster Anda:
Task | Method | ack-onepilot version |
Sematkan versi agen tertentu (self-service) | V3.0.17 atau lebih baru | |
Luncurkan versi ke subset instans terlebih dahulu | V3.3.0 atau lebih baru | |
Sematkan versi saat self-service tidak tersedia | Sebelum V3.0.17 |
Tentukan versi agen
Prasyarat: ack-onepilot V3.0.17 atau lebih baru. Untuk memeriksa versi, buka Container Service Management Console, klik Add-ons, temukan ack-onepilot, lalu periksa versinya. Jika tersedia peningkatan, klik Upgrade.
Ini adalah pendekatan yang direkomendasikan untuk mengontrol versi agen. Tersedia tiga metode. Jika Anda menggunakan Metode 1 bersama Metode 2 atau Metode 1 bersama Metode 3, versi yang ditentukan oleh Metode 2 atau Metode 3 akan mengambil prioritas atas Metode 1.
Langkah 1: Temukan versi agen target
Masuk ke ARMS console.
Di panel navigasi kiri, pilih .
Catat nomor versi yang akan digunakan. Pilih versi stabil terbaru kecuali lingkungan Anda memerlukan versi tertentu.
Di tab Agent Online Status, catat versi agen saat ini untuk setiap aplikasi. Versi ini menjadi target rollback jika terjadi masalah.
Langkah 2: Terapkan versi
Pilih salah satu metode berikut.
Metode 1: Label YAML
Tambahkan label aliyun.com/agent-version ke file YAML aplikasi:
metadata:
labels:
aliyun.com/agent-version: "<agent-version>"Ganti <agent-version> dengan nomor versi dari Langkah 1.
Setelah menyimpan file dan mengklik Update, aplikasi akan restart secara otomatis untuk menerapkan versi yang ditentukan.
Label ini hanya berlaku untuk aplikasi saat ini. Ulangi langkah ini untuk setiap aplikasi yang memerlukan penyematan versi.
Metode 2: Konsol EDAS
Saat men-deploy aplikasi ke kluster Kubernetes melalui Enterprise Distributed Application Service (EDAS) console, tentukan versi agen di bagian Monitoring and Governance Configurations pada tab Advanced Settings.
Untuk menyesuaikan versi agen yang tersedia di EDAS, hubungi dukungan teknis EDAS.
Metode 3: API EDAS
Saat membuat atau men-deploy aplikasi melalui API EDAS, atur parameter CustomAgentVersion dalam operasi InsertK8sApplication atau DeployK8sApplication.
Langkah 3: Verifikasi dan luncurkan
Terapkan versi tersebut ke aplikasi uji terlebih dahulu.
Validasi bahwa aplikasi berjalan sesuai harapan dengan versi agen baru.
Setelah validasi berhasil, ulangi Langkah 2 untuk aplikasi lainnya.
Jika versi agen baru menyebabkan masalah, ubah kembali label atau parameter ke versi sebelumnya yang telah dicatat di Langkah 1 untuk melakukan rollback.
Aktifkan pembaruan progresif
Prasyarat: ack-onepilot V3.3.0 atau lebih baru. Beban kerja aplikasi harus memiliki tiga replika atau lebih.
Pembaruan progresif memungkinkan Anda memvalidasi versi agen baru pada subset kecil instans sebelum diterapkan ke seluruh beban kerja.
Tambahkan kedua label berikut ke file YAML aplikasi:
metadata:
labels:
aliyun.com/agent-version: "<agent-version>"
aliyun.com/enable-progressive-update: "true"Saat Anda redeploy beban kerja Deployment atau StatefulSet di kluster ACK dengan pembaruan progresif diaktifkan, hanya satu hingga dua instans yang menerima versi agen yang ditentukan. Instans lainnya tetap menggunakan versi saat ini.
Batasan
Pembaruan progresif memerlukan minimal tiga replika. Jika beban kerja memiliki kurang dari tiga replika, tidak ada instans yang diperbarui ke versi yang ditentukan meskipun label telah disetel. Dalam kasus ini, jangan aktifkan pembaruan progresif untuk beban kerja tersebut.
Pembaruan progresif hanya berlaku untuk beban kerja Deployment dan StatefulSet.
Hubungi dukungan teknis untuk menyematkan versi
Gunakan metode ini jika ack-onepilot lebih lama dari V3.0.17 atau jika lingkungan Anda memerlukan modifikasi YAML secara manual. Pendekatan ini menggunakan penguncian versi untuk memigrasikan agen dari versi yang sudah tidak didukung atau usang ke versi terbaru.
Pilih aplikasi uji. Hubungi dukungan teknis ARMS untuk mengunci agen ke versi target.
Restart aplikasi uji dan validasi versi agen baru.
Setelah validasi berhasil, hubungi dukungan teknis ARMS untuk memperbarui versi yang dikunci ke kluster lainnya secara bertahap.
Restart aplikasi di setiap batch untuk menerapkan pembaruan.
Praktik terbaik
Validasi sebelum peluncuran luas: Sematkan versi baru pada satu aplikasi uji terlebih dahulu. Pastikan operasi normal sebelum memperbarui aplikasi lainnya.
Gunakan pembaruan progresif untuk beban kerja produksi: Untuk beban kerja dengan tiga replika atau lebih, aktifkan pembaruan progresif guna membatasi dampak selama perubahan versi.
Catat versi saat ini sebelum perubahan: Sebelum menyematkan versi baru, catat versi agen saat ini di tab Agent Online Status agar Anda dapat melakukan rollback dengan cepat.
Perbarui ack-onepilot secara berkala: Upgrade ack-onepilot ke V3.0.17 atau lebih baru untuk mengakses fitur penyematan versi mandiri (self-service), atau ke V3.3.0 atau lebih baru untuk mendapatkan pembaruan progresif tanpa bergantung pada dukungan teknis.