Panduan ini menjelaskan cara melakukan migrasi dari registri ZooKeeper yang dikelola sendiri untuk Dubbo ke registri MSE ZooKeeper.
Prasyarat
-
Anda telah menerapkan tool MSE Sync. Untuk informasi selengkapnya, lihat Solusi migrasi MSE Sync.
-
Anda telah membuat kluster MSE ZooKeeper. Untuk informasi selengkapnya, lihat Buat engine ZooKeeper.
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 |
-
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
-
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:2181Jika 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.
-
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.
-
-
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.
-
-
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
-
Masuk ke Konsol MSE, lalu pilih wilayah di bilah navigasi atas.
-
Di panel navigasi sebelah kiri, pilih Microservices Registry > Instances.
-
Di halaman Instances, klik nama instans.
-
Di panel navigasi sebelah kiri, pilih . Verifikasi bahwa layanan tercantum di bawah path Dubbo default.
Langkah 3: Migrasi client Dubbo
-
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"/> -
Restart aplikasi client. Aplikasi tersebut kemudian akan terhubung ke registri MSE ZooKeeper.
CatatanUntuk 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
-
Matikan kluster ZooKeeper sumber.
-
Hentikan tool MSE Sync.