All Products
Search
Document Center

Microservices Engine:Migrasi Dubbo ZooKeeper yang dikelola sendiri ke MSE ZooKeeper

Last Updated:Aug 21, 2026

Panduan ini menjelaskan cara melakukan migrasi dari registri ZooKeeper yang dikelola sendiri untuk Dubbo ke registri MSE ZooKeeper.

Prasyarat

Batasan

  • Kegagalan pada tool MSE Sync dapat mengganggu layanan sinkronisasi. Untuk ketersediaan tinggi, kami menyarankan Anda menerapkan minimal dua node untuk tool tersebut. Setelah memulai migrasi, selesaikan semua langkah secara tepat waktu.

  • Pastikan konektivitas jaringan antara kluster ZooKeeper sumber, tool MSE Sync, dan kluster MSE ZooKeeper tujuan.

Spesifikasi

Dubbo services

Providers

Consumers

Minimum instance specifications

Minimum tool specifications

0 hingga 1.000

0 hingga 3.000

0 hingga 9.000

2-core, 4 GB

2-core, 4 GB

1.000 hingga 4.000

0 hingga 12.000

0 hingga 36.000

4-core, 8 GB

4-core, 8 GB

4.000 hingga 7.000

0 hingga 21.000

0 hingga 63.000

8-core, 16 GB

4-core, 8 GB

7.000 hingga 10.000

0 hingga 30.000

0 hingga 90.000

16-core, 32 GB

8-core, 16 GB

Catatan
  • Spesifikasi instance minimum: Kami menyarankan menerapkan minimal tiga node untuk lingkungan produksi dan minimal lima node untuk lingkungan mission-critical.

  • Spesifikasi tool minimum: Untuk ketersediaan tinggi, kami menyarankan menerapkan minimal dua node.

Prosedur

Gambar berikut menunjukkan arsitektur penerapan untuk migrasi.部署结构

Langkah 1: Buat tugas sinkronisasi

  1. Di panel navigasi sebelah kiri tool MSE Sync, klik Cluster configuration, lalu klik Add Cluster. Di kotak dialog Add Cluster, konfigurasikan kluster ZooKeeper sumber dan klik OK.

    Parameter

    Description

    Cluster Name

    Masukkan nama kustom untuk kluster.

    Cluster type

    ZK

    Cluster IP address list

    Masukkan alamat IP dan port setiap node di kluster ZooKeeper sumber Anda, satu per baris. Port default adalah 2181. Contoh:

    127.0.0.1:2181
    127.0.0.2:2181
    127.0.0.3:2181

    Jika kluster sumber menggunakan Instance Server Load Balancer (SLB) untuk load balancing, masukkan alamat IP dan port Instance SLB tersebut di bidang Cluster IP address list.

  2. Klik Add Cluster lagi untuk menambahkan kluster ZooKeeper tujuan.

    • Cluster type: Pilih ZK.

    • Cluster IP address list: Masukkan endpoint dan port layanan kluster MSE ZooKeeper tujuan. Contoh: mse-8b7de****-p.zk.mse.aliyuncs.com:2181.

    Klik Add Cluster, masukkan Cluster Name (misalnya, MSE zk) di kotak dialog, lalu klik OK.

  3. Di panel navigasi sebelah kiri, klik Sync Task, lalu klik New Sync untuk menambahkan layanan Dubbo yang akan dimigrasi.

    • Sync Method: Pilih Bidirectional. Ini mengaktifkan sinkronisasi dua arah, yang menyinkronkan perubahan antara kluster sumber dan tujuan.

    • Synchronization Type: Pilih Service Information. MSE Sync secara otomatis mencantumkan semua layanan di kluster sumber. Pilih layanan yang diperlukan.

    • Group name: Jika Anda menyinkronkan beberapa layanan, Anda dapat mengosongkan parameter ini. Jika tidak, masukkan nama grup Dubbo tertentu.

    Pilih Source ZK dari daftar drop-down Source Cluster, pilih MSE zk dari daftar drop-down Target Cluster, pilih com.example.IHelloService dari daftar layanan, lalu klik OK.

  4. Klik OK.

    Di halaman Service Synchronization tool migrasi, lihat nama layanan yang telah disinkronkan.

    Setelah tugas ditambahkan, Anda dapat melihat tugas sinkronisasi yang telah dibuat di daftar Synchronization Tasks, termasuk kluster sumber, kluster tujuan, progres tugas, dan jenis tugas. Ketika progres tugas menampilkan Synchronization Complete (Listening), data telah tersinkronkan dan perubahan sumber terus dipantau.

Langkah 2: Verifikasi hasil sinkronisasi

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

  2. Di panel navigasi sebelah kiri, pilih Microservices Registry > Instances.

  3. Di halaman Instances, klik nama instans.

  4. Di panel navigasi sebelah kiri, pilih Data Management > Znodes. Verifikasi bahwa layanan tercantum di bawah path Dubbo default.

Langkah 3: Migrasi client Dubbo

  1. Ubah endpoint dalam konfigurasi client Dubbo Anda.

    Temukan file konfigurasi XML untuk client Dubbo Anda. Di atribut dubbo:registry address, ganti endpoint ZooKeeper yang dikelola sendiri dengan endpoint registri MSE ZooKeeper.

    Sebelum:

     <dubbo:registry address="zookeeper://127.0.0.1:2181"/>

    Sesudah:

     <dubbo:registry address="zookeeper://mse-8b7de****-p.zk.mse.aliyuncs.com:2181"/>
  2. Restart aplikasi client. Aplikasi tersebut kemudian akan terhubung ke registri MSE ZooKeeper.

    Catatan

    Untuk menghindari gangguan layanan, kami menyarankan Anda melakukan restart client secara bertahap. Setelah semua client direstart, verifikasi bahwa mereka telah terputus dari kluster sumber.

Langkah 4: Nonaktifkan kluster sumber

  1. Matikan kluster ZooKeeper sumber.

  2. Hentikan tool MSE Sync.