Tentukan versi agen ARMS - Application Real-Time Monitoring Service

Komponen ack-onepilot mengelola pembaruan otomatis Agen Layanan Pemantauan Aplikasi Real-Time (ARMS) di kluster Kubernetes. Untuk mempertahankan versi agen tertentu alih-alih mengikuti pembaruan otomatis, gunakan panduan ini untuk mengunci versi agen. Setelah validasi berhasil di lingkungan pengujian, lakukan pembaruan versi agen secara bertahap di semua aplikasi.

Solusi 1 (direkomendasikan): Tentukan versi agen secara manual

Versi ack-onepilot yang diperlukan

Ack-onepilot harus V3.0.17 atau lebih baru.

Untuk melihat versi ack-onepilot dari kluster Container Service for Kubernetes (ACK), buka Konsol ACK, klik Add-ons, temukan ack-onepilot, dan periksa versinya. Jika versinya tidak memenuhi persyaratan, klik Upgrade untuk memperbaruinya.

Tentukan versi agen dengan memodifikasi bidang label dalam file YAML aplikasi. Operasi ini akan menimpa pembaruan otomatis agen ARMS, memastikan bahwa agen dengan versi yang ditentukan digunakan.

Masuk ke Konsol ARMS. Di panel navigasi sisi kiri, pilih Application Monitoring > Agent Management > Agent Release Notes untuk melihat versi agen online yang tersedia. Kami merekomendasikan Anda memilih versi terbaru.
Pada tab Agent Online Status, periksa versi agen saat ini dari aplikasi Anda untuk rollback jika diperlukan.
Tentukan versi agen untuk aplikasi Anda.
Catatan
Jika Anda menggunakan metode 1 dan metode 2 atau metode 1 dan metode 3, versi yang ditentukan oleh metode 2 atau metode 3 memiliki prioritas lebih tinggi daripada yang ditentukan oleh metode 1.
- Metode 1: Modifikasi file YAML aplikasi. Tambahkan "aliyun.com/agent-version: Versi agen" di bawah bidang labels dan klik Perbarui. Aplikasi akan secara otomatis restart untuk menerapkan modifikasi.
  Modifikasi ini hanya berlaku pada aplikasi saat ini. Untuk aplikasi lainnya, modifikasi file YAML mereka sesuai.
  Jika komponen ack-onepilot adalah V3.3.0 atau lebih baru, Anda dapat mengontrol versi agen dalam mode pembaruan progresif dengan menambahkan label berikut di bawah aliyun.com/agent-version.
```
aliyun.com/enable-progressive-update: 'true'
```
  Catatan
  Ketika Anda menerapkan ulang beban kerja (Deployment atau StateSet) di kluster ACK dalam mode pembaruan progresif, hanya satu atau dua instans agen yang diperbarui ke versi yang ditentukan oleh aliyun.com/agent-version. Versi agen yang diinstal di instans lain tetap tidak berubah.
  Jika beban kerja aplikasi berisi kurang dari tiga replika, pembaruan progresif tidak berlaku. Bahkan jika Anda menentukan versi agen, semua replika tidak diperbarui ke versi yang ditentukan. Dalam hal ini, kami merekomendasikan agar Anda tidak mengaktifkan pembaruan progresif untuk beban kerja tersebut.
- Metode 2: Saat menerapkan aplikasi ke kluster Kubernetes di konsol Enterprise Distributed Application Service (EDAS), tentukan versi agen di bagian Monitoring and Governance Configurations pada tab Advanced Settings.
  Catatan
  Untuk menyesuaikan versi agen yang tersedia, hubungi dukungan teknis EDAS.
- Metode 3: Jika aplikasi dibuat atau diterapkan di kluster Kubernetes dengan memanggil operasi InsertK8sApplication atau DeployK8sApplication dari API EDAS, Anda dapat menggunakan parameter CustomAgentVersion untuk menentukan versi agen untuk aplikasi.
Verifikasi versi agen yang ditentukan di lingkungan pengujian sebelum Anda memperbarui agen untuk aplikasi lainnya.
Jika versi agen baru mengalami masalah, Anda dapat melakukan rollback versi agen dengan melakukan operasi di Langkah 3.

Solusi 2: Hubungi dukungan teknis untuk menentukan versi agen

Untuk versi ack-onepilot lebih awal dari 3.0.17 atau lingkungan yang memerlukan modifikasi YAML manual, gunakan penguncian versi untuk memigrasi agen dari versi yang sudah tidak digunakan atau tidak didukung ke versi terbaru:

Pilih aplikasi untuk memverifikasi pembaruan di lingkungan pengujian. Hubungi dukungan teknis ARMS untuk memperbarui versi agen yang dikunci dari aplikasi ke versi terbaru. Setelah pembaruan selesai, mulai ulang aplikasi untuk memverifikasi pembaruan.
Setelah versi baru diverifikasi di lingkungan pengujian, hubungi dukungan teknis ARMS untuk memperbarui agen yang dikunci secara bertahap untuk kluster yang perlu diperbarui. Setelah versi online baru berlaku, mulai ulang aplikasi secara bertahap.