All Products
Search
Document Center

Microservices Engine:Upgrade versi engine Nacos

Last Updated:Jul 04, 2026

MSE Microservices Registry menyediakan edisi Profesional dan Developer. Anda dapat meng-upgrade versi engine Nacos atau melakukan migrasi dari Edisi Dasar yang tidak lagi tersedia melalui Konsol MSE.

Latar Belakang

Edisi Dasar MSE Microservices Registry akan dihentikan, dan instans-instansnya akan dinonaktifkan pada pukul 12.00 (UTC+8), 3 Maret 2025. Setelah waktu tersebut, Anda tidak akan lagi dapat mengakses instans-instans ini baik melalui konsol maupun aplikasi Anda. Dukungan dan layanan tiket untuk instans Edisi Dasar tetap tersedia hingga batas waktu tersebut. Untuk informasi selengkapnya, lihat pemberitahuan Penghentian MSE Microservices Registry Edisi Dasar.

Sebelum memulai

  • Pilih edisi instans: Sebelum melakukan upgrade, rujuk ke Panduan Pemilihan Edisi Instans untuk menentukan apakah akan meng-upgrade ke edisi Developer atau Profesional. Untuk detail penagihan, lihat Ikhtisar Penagihan Instans Umum.

  • Evaluasi spesifikasi: Selama proses upgrade, MSE Nacos melakukan doublewrite terhadap data layanan terdaftar untuk memastikan konsistensi data. Sebelum memulai, pastikan jumlah instans provider dalam kluster Anda tidak melebihi kapasitas spesifikasi edisi dasar Anda. Untuk informasi lebih lanjut, lihat Evaluasi Kemampuan Instans Umum.

  • Periksa versi engine: Anda hanya dapat meng-upgrade instans edisi dasar ke edisi Profesional atau Developer jika engine Nacos Anda berada pada versi 1.2.1.0 atau lebih baru. Jika Anda menggunakan versi 1.1.3.x, Anda harus terlebih dahulu meng-upgrade ke versi 1.2.1, lalu meng-upgrade edisi instans. Untuk petunjuknya, lihat Upgrade versi engine Nacos.

  • Tinjau kompatibilitas versi engine: Untuk informasi tentang fitur-fitur pada berbagai versi engine MSE Nacos, lihat Versi engine Nacos. Demi stabilitas sistem, hindari penggunaan versi Nacos SDK yang dibatasi. Untuk detailnya, lihat Versi Nacos SDK yang Dibatasi.

  • Engine Eureka: Layanan Eureka yang dikelola MSE telah dihentikan. MSE Nacos mendukung protokol Eureka dan kompatibel dengan klien Eureka. Lakukan migrasi instans edisi dasar Eureka Anda ke edisi Profesional atau Developer MSE Nacos.

Dampak upgrade

  • Proses upgrade memakan waktu sekitar 10 menit. Selama periode ini, Anda tidak dapat melakukan operasi apa pun terhadap instans di konsol. Kami menyarankan melakukan upgrade pada jam sepi agar tidak mengganggu layanan Anda.

  • Untuk instans dengan tiga node atau lebih, upgrade dilakukan menggunakan penyebaran bergulir (rolling deployment) di seluruh node dengan sinkronisasi data otomatis. Hal ini menjamin upgrade tanpa downtime.

  • Instans dengan satu atau dua node bukanlah instans ber-Ketersediaan tinggi, sehingga upgrade akan menyebabkan downtime.

  • Upgrade dirancang agar tidak mengganggu layanan Anda. Namun, koneksi ulang jaringan mungkin terjadi, menghasilkan log koneksi ulang. Data pemantauan juga mungkin menunjukkan fluktuasi sementara akibat restart kluster.

  • Saat melakukan upgrade dari engine Eureka ke edisi Profesional atau Developer Nacos:

    • Anda tidak perlu memodifikasi kode aplikasi Anda.

    • Koneksi ulang jaringan selama upgrade dapat menyebabkan kegagalan pembaruan heartbeat pada sejumlah kecil instans terdaftar. Klien Eureka akan secara otomatis mencoba mendaftar ulang pada siklus pembaruan berikutnya dan akan pulih setelah terhubung ke node server yang sehat.

    • Secara default, instans edisi dasar Eureka dimigrasikan ke edisi Developer atau Profesional Nacos dengan versi engine 2.1.2.2. Anda dapat meng-upgrade ke versi Nacos terbaru di kemudian hari. Untuk informasi selengkapnya, lihat Upgrade versi engine Nacos.

Jalur upgrade

Anda hanya dapat meng-upgrade dari edisi dasar ke edisi Profesional atau Developer jika engine Nacos Anda berada pada versi 1.2.1.0 atau lebih baru. Jika Anda menggunakan versi 1.1.3.x, Anda harus terlebih dahulu meng-upgrade engine ke versi 1.2.1. Untuk petunjuknya, lihat Upgrade versi engine Nacos.

Upgrade versi engine Nacos

Penting
  • Nacos 1.1.3 telah dihentikan dan tidak lagi dipelihara. Untuk menghindari masalah, segera upgrade versi engine Anda ke 1.2.1 atau lebih baru.

  • Anda tidak dapat melakukan rollback versi dari konsol setelah upgrade. Jika memiliki pertanyaan, bergabunglah dengan grup DingTalk dengan ID 43525005207 untuk mendapatkan bantuan.

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

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

  3. Anda dapat memulai upgrade dari konsol dengan salah satu dari dua cara berikut:

    Catatan

    Jika instans target sudah berada pada versi terbaru, opsi Manual Upgrade tidak akan ditampilkan.

    Metode 1

    Pada halaman Instances, temukan instans target lalu klik Manual Upgrade di kolom Engine Version.

    Metode 2

    Pada halaman Instances, klik instans yang ingin Anda upgrade. Di halaman Basic Information, klik Manual Upgrade di samping Engine Version.

  4. Pada kotak dialog Cluster Upgrade, klik OK.

Upgrade edisi dasar Nacos/Eureka

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

  2. Di halaman Instances, temukan instans MSE, lalu klik More di kolom Actions.

    • Untuk instans subscription, pilih Upgrade atau Downgrade sesuai kebutuhan bisnis Anda.

    • Untuk instans pay-as-you-go, pilih Upgrade/Downgrade.

  3. Di halaman perubahan spesifikasi, pilih Product Edition:

    • Untuk instans single-node, pilih Developer edition.

    • Untuk instans multi-node, pilih Professional edition.

    Penting

    Batasan berikut berlaku saat Anda mengubah Product Edition:

    • Instans Basic Edition dapat di-upgrade ke Developer Edition atau Professional Edition.

    • Instans Developer Edition hanya dapat di-upgrade ke versi Developer Edition yang lebih baru. Instans ini tidak dapat di-upgrade ke Professional Edition.

    • Instans Professional Edition hanya dapat di-upgrade ke versi Professional Edition yang lebih baru. Instans ini tidak dapat diturunkan spesifikasinya ke Developer Edition.

  4. Konfirmasi Engine specification dan Number of Cluster Nodes. Setelah memverifikasi total biaya di pojok kanan bawah, klik Buy now.

FAQ

Versi klien

T: Apakah edisi profesional mendukung klien versi lama?

J: Pusat konfigurasi kompatibel dengan semua versi klien Nacos 1.0.0 ke atas. Fitur penemuan layanan kompatibel dengan semua versi klien Nacos 1.2.0 ke atas. Namun, klien Nacos 1.x.x tidak mendukung koneksi persisten. Oleh karena itu, kami merekomendasikan penggunaan klien Nacos 2.0.0 atau lebih baru.

T: Bagaimana cara meng-upgrade klien Spring Cloud Alibaba atau Dubbo?

Spring Cloud Alibaba

Untuk meng-upgrade klien Nacos untuk Spring Cloud Alibaba, tentukan di dependensi Anda:

<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    <version>${springcloudalibaba.version}</version>
    <exclusions>
        <exclusion>
        <groupId>com.alibaba.nacos</groupId>
        <artifactId>nacos-client</artifactId>
         </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>${springcloudalibaba.version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
    <version>2.0.2</version>
</dependency>

Dubbo

Untuk meng-upgrade klien Nacos untuk Dubbo, tentukan di dependensi Anda:

Penting

Versi Dubbo 2.7.8 memiliki bug kritis yang membuat terlalu banyak instans klien Nacos, menyebabkan lonjakan koneksi dan thread. Upgrade versi Dubbo Anda sebelum meng-upgrade klien Nacos. Untuk informasi selengkapnya, lihat detail isu.

<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-registry-nacos</artifactId>
    <version>${dubbo.version}</version>
    <exclusions>
        <exclusion>
            <groupId>com.alibaba.nacos</groupId>
            <artifactId>nacos-client</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency>
    <groupId>com.alibaba.nacos</groupId>
    <artifactId>nacos-client</artifactId>
    <version>2.0.2</version>
</dependency>

Error setelah upgrade

Error: Connection is unregistered atau Client not connected,current status:STARTING

  • Gejala: Setelah Anda meng-upgrade instans MSE ke edisi profesional dan memperbarui klien Nacos di aplikasi Anda, aplikasi gagal memulai dan menampilkan error Connection is unregistered atau Client not connected,current status:STARTING.

  • Penyebab: Klien tidak dapat membuat koneksi gRPC dengan server. Ikuti langkah-langkah berikut untuk pemecahan masalah:

    1. Uji konektivitas jaringan dengan menjalankan perintah telnet ${nacos.server.address}:9848.

    2. Periksa apakah aplikasi Anda dan instans MSE berada dalam VPC yang sama.

    3. Jika Anda terhubung melalui internet, Anda harus terlebih dahulu mengonfigurasi daftar putih alamat IP publik.

  • Anda tidak perlu mengubah konfigurasi port di aplikasi Anda. Tetap gunakan port 8848. Klien Nacos akan secara otomatis menghitung port gRPC yang benar.

Error: Nacos cluster is running with 1.X mode, can't accept gRPC request temporarily.

  • Gejala: Setelah Anda meng-upgrade MSE ke edisi profesional dan klien aplikasi, terjadi error startup: "Nacos cluster is running with 1.X mode, can't accept gRPC request temporarily.”.

  • Penyebab: Instans edisi profesional MSE melakukan proses doublewrite dan validasi untuk menyinkronkan data antara versi lama dan baru, memastikan konsistensi data setelah pergantian. Selama periode ini, instans sementara menolak permintaan dari klien Nacos 2.0.0. Permintaan dari klien Nacos 1.x.x dan operasi konsol tidak terpengaruh. Instans akan secara otomatis beralih setelah proses sinkronisasi dan validasi selesai. Proses ini biasanya memakan waktu 5 hingga 20 menit, tergantung ukuran instans.

  • Rekomendasi: Jika mengalami masalah ini, tunggu beberapa menit lalu restart aplikasi Anda.