All Products
Search
Document Center

Microservices Engine:Tentukan versi agen Microservices Governance

Last Updated:Mar 12, 2026

Microservices Engine (MSE) secara default menggunakan versi agen stabil terbaru. Untuk menjaga konsistensi di berbagai lingkungan, mengunci rilis yang telah diuji, atau mengatur waktu upgrade, Anda dapat mengunci agen ke versi tertentu.

Metode yang digunakan bergantung pada lingkungan deployment Anda:

LingkunganMetodeRingkasan
Container Service for Kubernetes (ACK)Label PodTambahkan aliyun.com/agent-version ke YAML deployment Anda
Elastic Compute Service (ECS)Unduh manualUnduh paket agen tertentu dan konfigurasikan secara manual

Periksa versi agen saat ini

  1. Masuk ke Konsol MSE dan pilih wilayah di bilah navigasi atas.

  2. Di panel navigasi kiri, pilih Microservices Governance > Application Governance.

  3. Pada halaman Application list, klik kartu resource aplikasi target.

  4. Di panel navigasi kiri, klik Node details.

  5. Pada bagian All Nodes, klik node target. Di tab Basic Information, temukan versinya di kolom Probe Version.

Agent version displayed in the Probe Version column

Tentukan versi agen di ACK (ack-onepilot)

Gunakan metode ini jika aplikasi Anda berjalan di ACK dengan komponen ack-onepilot.

Prasyarat

Kunci versi agen

Tambahkan label aliyun.com/agent-version ke spesifikasi pod dalam YAML deployment Anda. Contoh berikut mengunci agen ke versi 4.2.5:

spec:
  template:
    metadata:
      labels:
        aliyun.com/agent-version: "4.2.5"
        mseNamespace: "default"                # namespace layanan mikro MSE
        msePilotCreateAppName: "<yourAppName>"  # Ganti dengan nama aplikasi Anda

Tabel berikut menjelaskan label tersebut:

LabelDeskripsiWajib
aliyun.com/agent-versionVersi agen yang akan digunakan (misalnya, 4.2.5). Jika tidak ditentukan, MSE akan menggunakan versi stabil terbaru.Tidak
mseNamespaceNamespace layanan mikro MSE tempat aplikasi beradaYa
msePilotCreateAppNameNama aplikasi yang terdaftar di MSEYa
Catatan

Sebelum menentukan versi, pastikan versi tersebut tersedia dengan mengunduh paket agen dari salah satu titik akhir berikut:

  • Titik akhir publik: http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip

  • Titik akhir internal: http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip

Untuk daftar versi yang tersedia, lihat Versi agen Java.

Untuk kembali ke perilaku default (versi stabil terbaru), hapus label aliyun.com/agent-version dan restart aplikasi.

Verifikasi hasil

Setelah menerapkan deployment yang diperbarui dan me-restart aplikasi, konfirmasi versi agen di halaman Node details seperti dijelaskan pada bagian Periksa versi agen saat ini di atas.

Confirming the agent version after restart

Tentukan versi agen di ECS

Jika aplikasi Anda berjalan di Elastic Compute Service (ECS), unduh paket agen untuk versi target dan aktifkan Microservices Governance secara manual. Untuk prosedur penyiapan lengkap, lihat Aktifkan Microservices Governance untuk aplikasi layanan mikro di instance ECS.

Unduh paket agen

Unduh paket agen dari salah satu titik akhir berikut:

  • Titik akhir publik: http://arms-apm-${regionId}.oss-${regionId}.aliyuncs.com/${agentVersion}/ArmsAgent.zip

  • Titik akhir internal: http://arms-apm-${regionId}.oss-${regionId}-internal.aliyuncs.com/${agentVersion}/ArmsAgent.zip

Ganti placeholder dengan nilai Anda:

PlaceholderDeskripsiContoh
${regionId}ID wilayah tempat aplikasi dideploycn-hangzhou, ap-southeast-1
${agentVersion}Versi agen target4.2.5
Catatan

Gunakan titik akhir internal di lingkungan Virtual Private Cloud (VPC) dan titik akhir publik di lingkungan non-VPC. Untuk wilayah yang didukung, lihat Wilayah yang didukung. Untuk versi agen yang tersedia, lihat Versi agen Java.

Catatan

Untuk mengunduh paket agen bagi aplikasi di wilayah China East 1 Finance, kirim tiket.