All Products
Search
Document Center

Microservices Engine:Migrasi aplikasi dari registri Eureka yang dikelola sendiri ke registri Nacos MSE

Last Updated:Mar 11, 2026

Topik ini menjelaskan cara memigrasikan aplikasi layanan mikro dari registri Eureka yang dikelola sendiri ke registri Nacos Microservices Engine (MSE) dengan downtime minimal. Migrasi ini menggunakan tool MSE Sync untuk melakukan sinkronisasi layanan dua arah, sehingga aplikasi tetap tersedia selama proses berlangsung.

Cara kerja

MSE Sync menghubungkan instans Eureka yang dikelola sendiri dan instans Nacos MSE dengan melakukan sinkronisasi pendaftaran layanan secara real time. Selama migrasi, kedua registri tetap tersinkronisasi:

  1. Aplikasi yang masih terhubung ke Eureka dapat menemukan layanan yang telah dipindahkan ke Nacos.

  2. Aplikasi yang sudah berada di Nacos dapat menemukan layanan yang masih terdaftar di Eureka.

  3. Setelah semua aplikasi beralih ke Nacos, Anda dapat mendekomisioning instans Eureka dan menghentikan MSE Sync.

Prasyarat

Sebelum memulai, pastikan Anda telah memiliki:

Batasan

  • Jika tool MSE Sync mati, sinkronisasi akan berhenti. Deploy MSE Sync pada minimal dua node untuk ketersediaan tinggi.

  • Selesaikan migrasi secepat mungkin setelah dimulai. Jembatan sinkronisasi ini merupakan keadaan transisi, bukan arsitektur jangka panjang.

Langkah 1: Buat tugas migrasi

Tambahkan kluster Eureka sumber

  1. Pada panel navigasi kiri tool MSE Sync, klik Cluster Configuration.

  2. Klik Add Cluster.

  3. Pada kotak dialog Add Cluster, konfigurasikan parameter berikut dan klik OK.

    ParameterDescription
    Cluster NameMasukkan nama untuk instans sumber.
    Cluster TypePilih EUREKA.
    Cluster IP Address ListMasukkan alamat IP dan port instans Eureka sumber, satu entri per baris. Port default adalah 8761. Jika instans sumber menggunakan instans Server Load Balancer (SLB), masukkan alamat IP dan port SLB tersebut.

Tambahkan kluster Nacos tujuan

  1. Pada halaman Cluster Configuration, klik Add Cluster lagi.

  2. Pada kotak dialog Add Cluster, konfigurasikan parameter berikut dan klik OK.

    ParameterDescription
    Cluster NameMasukkan nama untuk instans tujuan.
    Cluster TypePilih Nacos.
    NamespaceNamespace default adalah public.
    Username / PasswordDiperlukan hanya jika autentikasi Nacos diaktifkan.
    Cluster IP Address ListMasukkan titik akhir dan port instans Nacos MSE. Port default adalah 8848. Contoh: mse-xxxxxxx-p.nacos-ans.mse.aliyuncs.com:8848.

Buat tugas sinkronisasi

  1. Pada panel navigasi kiri, klik Service Synchronization.

  2. Klik New Sync.

  3. Pada kotak dialog New Sync, konfigurasikan tugas sinkronisasi:

    • Sync Mode: Pilih Bidirection. Dalam mode ini, pendaftaran layanan disinkronkan dua arah—perubahan di salah satu sisi akan disebarkan ke sisi lainnya.

    • Sync Type: Pilih Service Information. MSE Sync secara otomatis mencantumkan semua aplikasi yang terdaftar pada instans Eureka sumber. Pilih aplikasi yang akan dimigrasikan sesuai kebutuhan Anda.

  4. Klik OK.

Nama aplikasi yang telah disinkronkan akan muncul pada halaman Service Synchronization.

Langkah 2: Verifikasi hasil sinkronisasi

  1. Login ke Konsol MSE dan pilih wilayah pada bilah navigasi atas.

  2. Pada panel navigasi kiri, pilih Microservices Registry > Instances.

  3. Pada halaman Instances, klik nama instans Nacos MSE.

  4. Pada panel navigasi kiri, pilih Service Management > Services.

  5. Verifikasi bahwa aplikasi yang Anda pilih pada Langkah 1 muncul dalam daftar layanan dengan jumlah instans yang diharapkan.

Langkah 3: Migrasi client

  1. Ganti titik akhir instans Eureka yang dikelola sendiri dengan titik akhir instans Nacos MSE.

  2. Restart client agar terhubung ke instans Nacos MSE.

    Penting

    Restart aplikasi secara bertahap untuk menjaga kelangsungan bisnis. Setelah setiap batch, verifikasi bahwa aplikasi yang telah direstart muncul sebagai instans sehat di konsol Nacos MSE sebelum melanjutkan ke batch berikutnya.

  3. Setelah semua aplikasi direstart, pastikan setiap aplikasi telah terdaftar di instans Nacos MSE dengan memeriksa halaman Services di Konsol MSE.

Langkah 4: Dekomisioning registri lama

Setelah semua aplikasi terhubung ke Nacos MSE:

  1. Matikan instans Eureka yang dikelola sendiri.

  2. Hentikan tool MSE Sync.