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, kunci agen ke versi tetap alih-alih menerima pembaruan otomatis.
Pilih metode berdasarkan versi ack-onepilot di kluster Anda:
| Task | Method | ack-onepilot version |
|---|---|---|
| Kunci ke versi agen tertentu (self-service) | Tentukan versi melalui label atau API | V3.0.17 atau lebih baru |
| Luncurkan versi ke subset instans terlebih dahulu | Aktifkan pembaruan progresif | V3.3.0 atau lebih baru |
| Kunci versi saat self-service tidak tersedia | Hubungi dukungan teknis | 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 3, versi yang ditentukan oleh Metode 2 atau Metode 3 akan mengambil prioritas atas Metode 1.
Langkah 1: Temukan versi agen target
Login ke ARMS console.
Pada panel navigasi kiri, pilih .
Catat nomor versi yang akan digunakan. Pilih versi stabil terbaru kecuali lingkungan Anda memerlukan versi tertentu.
Pada tab Agent Online Status, catat versi agen saat ini untuk setiap aplikasi. Versi ini menjadi target rollback jika terjadi masalah.
Langkah 2: Terapkan versi tersebut
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 penguncian versi.
Metode 2: Konsol EDAS
Saat menyebarkan aplikasi ke kluster Kubernetes melalui Konsol Enterprise Distributed Application Service (EDAS), 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 mencapai seluruh beban kerja.
Tambahkan kedua label berikut ke 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 diatur. 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 mengunci 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: Kunci 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 mengunci versi baru, catat versi agen saat ini pada 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 penguncian versi self-service, atau ke V3.3.0 atau lebih baru untuk mendukung pembaruan progresif tanpa bergantung pada dukungan teknis.