全部产品
Search
文档中心

Microservices Engine:Hubungkan aplikasi mikroservis ACK dan ACS ke pusat tata kelola MSE (Java)

更新时间:Nov 10, 2025

Anda dapat menghubungkan aplikasi mikroservis, seperti aplikasi Spring Cloud dan Dubbo, yang diterapkan di Container Service for Kubernetes dan Container Compute Service ke pusat tata kelola Microservices Engine (MSE). Dengan memanfaatkan fitur tata kelola layanan dari MSE, Anda dapat meningkatkan stabilitas dan efisiensi pengembangan mikroservis online secara signifikan. Topik ini menjelaskan cara menghubungkan aplikasi mikroservis ACK dan ACS ke pusat tata kelola MSE.

Prasyarat

Penting
  • Jika proyek Anda menggunakan komponen Sentinel open source dan com.alibaba.cloud.sentinel.feign.SentinelFeignAutoConfiguration secara bersamaan, koneksi ke pusat tata kelola MSE akan gagal.

  • Saat memasang agen Java MSE, memori heap JVM harus lebih besar dari 256 MB.

  • Pastikan kluster ACK memiliki izin untuk mengakses sumber daya MSE.

    Jika kluster memiliki token add-on ARMS, MSE memberikan otorisasi tanpa kata sandi. Secara default, kluster ACK yang dikelola telah dilengkapi token add-on ARMS. Namun, beberapa kluster ACK yang dikelola versi lama mungkin tidak memiliki token ini. Untuk kluster tersebut, periksa apakah token add-on ARMS tersedia.

    Ikuti langkah-langkah berikut untuk memeriksa keberadaan token add-on ARMS di kluster ACK yang dikelola:

    1. Masuk ke Konsol Container Service for Kubernetes. Pada halaman Clusters, klik nama kluster target untuk membuka halaman detailnya.

    2. Di panel navigasi sebelah kiri, pilih Configuration Management > Secrets. Di bagian atas halaman, atur Namespace menjadi kube-system dan periksa apakah addon.arms.token tersedia. Jika tidak tersedia, Anda harus memberikan izin yang diperlukan secara manual.

  • Jika Anda menggunakan Pengguna RAM untuk menyelesaikan integrasi cepat, lihat Izin bagi Pengguna RAM untuk melakukan integrasi cepat.

Prosedur

Catatan

Rekomendasi pemilihan jenis koneksi:

  • Jika semua atau sebagian besar aplikasi dalam suatu namespace perlu dihubungkan ke pusat tata kelola MSE, gunakan Skenario 1: Aktifkan tata kelola mikroservis MSE untuk aplikasi dalam namespace ACK atau ACS. Untuk aplikasi dalam namespace yang tidak perlu dihubungkan, tetapkan label: spec.template.labels.msePilotAutoEnable: "off".

  • Jika hanya beberapa aplikasi dalam suatu namespace yang perlu dihubungkan ke pusat tata kelola MSE, gunakan Skenario 2: Aktifkan tata kelola mikroservis MSE untuk satu aplikasi.

Skenario 1: Aktifkan tata kelola mikroservis MSE untuk aplikasi dalam namespace ACK atau ACS

Setelah Anda mengaktifkan tata kelola mikroservis MSE untuk suatu namespace, semua Pod untuk aplikasi baru maupun aplikasi yang sudah ada yang diterapkan ulang dalam namespace tersebut akan secara otomatis terhubung ke tata kelola mikroservis MSE tanpa perlu dikonfigurasi satu per satu. Untuk informasi selengkapnya tentang cara membuat aplikasi, lihat Buat beban kerja tanpa status (Deployment).

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

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

  3. Pada halaman Application list, klik ACK Application Access.

  4. Pada kotak dialog ACK Application Access, konfigurasikan parameter dan klik OK.

    image

    Parameter

    Deskripsi

    Cluster type

    Pilih ACK Cluster, ACK Serverless Cluster, atau ACS Cluster.

    Catatan

    Jika Anda belum memberikan izin Container Service for Kubernetes untuk memanggil Microservices Engine, klik Harap Otorisasi untuk memberikan izin tersebut.

    Cluster Name/ID

    Pilih nama atau ID Cluster Name/ID yang ingin Anda hubungkan ke tata kelola mikroservis MSE. Anda dapat mencari kluster berdasarkan kata kunci.

    ack-onepilot

    Status komponen ack-onepilot. Untuk informasi selengkapnya tentang komponen ack-onepilot dan cara memutakhirkan komponen tersebut, lihat komponen ack-onepilot dan Instal dan tingkatkan komponen tata kelola mikroservis MSE.

    • Jika ack-onepilot belum diinstal, sistem akan menginstalnya secara otomatis setelah Anda memilih kluster. Pesan berikut akan muncul: "The Installation Takes About 1 Minute. Please Wait."

      Jika Anda menggunakan Pengguna RAM dan tidak memiliki izin yang diperlukan, masuk ke Konsol Container Service for Kubernetes. Buka halaman detail kluster target. Klik Component Management, temukan ack-onepilot, lalu klik Install.

    • Jika ack-onepilot telah diinstal, konsol akan menampilkan "Terinstal" diikuti nomor versinya, misalnya, Terinstal 4.2.0.

    Catatan
    • Komponen yang diinstal pada langkah ini adalah ack-onepilot. Anda dapat masuk ke Konsol Container Service for Kubernetes, buka halaman detail kluster target, lalu pilih Operations Management > Component Management untuk melihat detailnya.

    • Setelah ack-onepilot diinstal, komponen tersebut akan secara otomatis menyuntikkan agen. Hal ini dapat meningkatkan waktu startup aplikasi hingga 10 detik.

    • Jika Anda menghubungkan berdasarkan namespace dan kluster target tidak berada di salah satu wilayah berikut, pastikan kluster dapat mengakses Internet dan terhubung ke acm.aliyun.com:8080: Qingdao, Hangzhou, Beijing, Shanghai, Shanghai-Finance Cloud, Shenzhen, Hong Kong (Tiongkok), Singapura, Frankfurt, Sydney, Silicon Valley, dan Virginia.

    Access Type

    Pilih Namespace Access.

    Cluster Namespace

    Pilih Cluster Namespace.

    Microservices Governance Namespace

    Pilih Microservices Governance Namespace.

Informasi tambahan:

  • Secara default, setelah aplikasi di kluster ACK/ACS terhubung ke pusat tata kelola MSE, konsol menggunakan nama deployment aplikasi sebagai nama tampilannya. Untuk menyesuaikan nama aplikasi, modifikasi konfigurasi YAML aplikasi yang diterapkan.

    spec:
      template:
        metadata:
          labels:
            # Namespace mikroservis MSE tempat aplikasi Anda berada. Nilai default adalah default.
            mseNamespace: default 
            # Ganti ini dengan nama aktual aplikasi Anda.
            msePilotCreateAppName: "your-deployment-name" 
  • Jika ingin menonaktifkan tata kelola mikroservis untuk aplikasi tertentu, tambahkan label msePilotAutoEnable ke konfigurasi YAML aplikasi yang diterapkan dan atur nilainya menjadi off.

    spec:
      template:
        metadata:
          labels:
            # Nilai "off" untuk bidang ini harus diapit tanda kutip ganda atau tunggal.
            msePilotAutoEnable: "off" 

Skenario 2: Aktifkan tata kelola mikroservis MSE untuk satu aplikasi

Jika hanya beberapa aplikasi dalam namespace Anda yang perlu dihubungkan ke tata kelola mikroservis MSE, Anda dapat menghubungkannya satu per satu.

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

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

  3. Pada halaman Application list, klik ACK Application Access.

  4. Pada kotak dialog ACK Application Access, konfigurasikan parameter dan klik OK.

    image

    Parameter

    Deskripsi

    Cluster type

    Pilih ACK Cluster, ACK Serverless Cluster, atau ACS Cluster.

    Catatan

    Jika Anda belum memberikan izin Container Service for Kubernetes untuk memanggil Microservices Engine, klik Harap Otorisasi untuk memberikan izin tersebut.

    Cluster Name/ID

    Pilih nama atau ID Cluster Name/ID yang ingin Anda hubungkan ke tata kelola mikroservis MSE. Anda dapat mencari kluster berdasarkan kata kunci.

    ack-onepilot

    Status komponen ack-onepilot. Untuk informasi selengkapnya tentang komponen ack-onepilot dan cara memutakhirkan komponen tersebut, lihat komponen ack-onepilot dan Instal dan tingkatkan komponen tata kelola mikroservis MSE.

    • Jika ack-onepilot belum diinstal, sistem akan menginstalnya secara otomatis setelah Anda memilih kluster. Pesan berikut akan muncul: "The Installation Takes About 1 Minute. Please Wait."

      Jika Anda menggunakan Pengguna RAM dan tidak memiliki izin yang diperlukan, masuk ke Konsol Container Service for Kubernetes. Buka halaman detail kluster target. Klik Component Management, temukan ack-onepilot, lalu klik Install.

    • Jika ack-onepilot telah diinstal, konsol akan menampilkan "Terinstal" diikuti nomor versinya, misalnya, Terinstal 4.2.0.

    Catatan
    • Komponen yang diinstal pada langkah ini adalah ack-onepilot. Anda dapat masuk ke Konsol Container Service for Kubernetes, buka halaman detail kluster target, lalu pilih Operations Management > Component Management untuk melihat detailnya.

    • Setelah ack-onepilot diinstal, komponen tersebut akan secara otomatis menyuntikkan agen. Hal ini dapat meningkatkan waktu startup aplikasi hingga 10 detik.

    • Jika Anda menghubungkan berdasarkan namespace dan kluster target tidak berada di salah satu wilayah berikut, pastikan kluster dapat mengakses Internet dan terhubung ke acm.aliyun.com:8080: Qingdao, Hangzhou, Beijing, Shanghai, Shanghai-Finance Cloud, Shenzhen, Hong Kong (Tiongkok), Singapura, Frankfurt, Sydney, Silicon Valley, dan Virginia.

    Access Type

    Pilih Single Application Access.

    Access Procedure

    Ikuti langkah-langkah berikut.

    Step 1: Go To The Workloads > Deployments Page Of The Cluster And Switch To The Namespace Of The Application.

    Step 2: Find The Application That You Want To Connect And Click "View In YAML".

    Step 3: Edit The Labels In The Following Format And Click "Update".

    spec:
      template:
        metadata:
          labels:
            # Atur nilai menjadi "on" untuk mengaktifkan koneksi. Nilai harus diapit tanda kutip ganda.
            msePilotAutoEnable: "on"
            # Tentukan namespace tata kelola yang akan dihubungkan. Jika namespace tidak ada, namespace tersebut akan dibuat secara otomatis.
            mseNamespace: default
            # Tentukan nama aktual aplikasi yang akan dihubungkan ke MSE. Nama harus diapit tanda kutip ganda.
            msePilotCreateAppName: "your-deployment-name"

Verifikasi hasil

Setelah menyelesaikan langkah-langkah di atas dan memulai ulang aplikasi, tata kelola mikroservis MSE akan diaktifkan untuk aplikasi yang diterapkan di Container Service for Kubernetes dan Container Compute Service.

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

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

  3. Pilih namespace mikroservis yang sesuai. Anda dapat melihat aplikasi yang telah berhasil terhubung.

Langkah selanjutnya

Setelah aplikasi Anda terhubung ke pusat tata kelola MSE, Anda dapat menggunakan fitur-fitur seperti peluncuran kanari ujung ke ujung, mulai dan matikan secara mulus, serta pembatasan lalu lintas. Untuk informasi selengkapnya, lihat Alami fitur tata kelola layanan dalam 15 menit (Java).