All Products
Search
Document Center

Microservices Engine:Tingkatkan versi mesin Nacos

Last Updated:Jul 28, 2026

Instans umum MSE Microservices Registry tersedia dalam edisi Profesional dan Developer (edisi Dasar tidak lagi dijual atau diperbarui). MSE Nacos juga memiliki versi mesinnya sendiri. Topik ini menjelaskan cara meningkatkan versi mesin Nacos di Konsol MSE.

Latar Belakang

Untuk memberikan layanan yang lebih baik dan menyederhanakan pemilihan edisi MSE Microservices Registry, layanan edisi Dasar MSE Microservices Registry akan dihentikan dan sumber daya instans akan dirilis pada pukul 12.00 (UTC+8), 3 Maret 2025. Setelah waktu tersebut, Anda tidak akan lagi dapat mengakses instans-instans tersebut dari konsol maupun aplikasi Anda. Dukungan dan layanan tiket untuk instans edisi Dasar tetap tersedia hingga batas waktu tersebut. Untuk detail selengkapnya, lihat Pengumuman Penghentian Edisi Dasar MSE Microservices Registry.

Sebelum memulai

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

  • Evaluasi spesifikasi: Selama peningkatan, MSE Nacos melakukan doublewrite pada data layanan terdaftar untuk memastikan konsistensi data dan stabilitas proses peningkatan. Sebelum memulai, pastikan jumlah instans penyedia di kluster Anda tidak melebihi jumlah maksimum instans untuk edisi Dasar sesuai spesifikasi yang berlaku, guna menghindari dampak doublewrite terhadap layanan Anda selama peningkatan. Untuk informasi lebih lanjut, lihat Evaluasi Kemampuan Instans Umum.

  • Periksa versi mesin: Anda hanya dapat meningkatkan instans edisi Dasar ke edisi Profesional atau Developer jika mesin Nacos Anda berada pada versi 1.2.1.0 atau lebih baru. Jika Anda menggunakan versi 1.1.3.x, Anda harus terlebih dahulu meningkatkan ke versi 1.2.1, lalu meningkatkan edisi instans. Untuk petunjuknya, lihat Tingkatkan versi mesin Nacos.

  • Tinjau kompatibilitas versi mesin: Untuk detail fitur versi mesin MSE Nacos, lihat Versi mesin Nacos. Demi stabilitas sistem, kami menyarankan untuk menghindari versi Nacos SDK yang dibatasi. Untuk alasan dan solusinya, lihat Versi Nacos SDK yang dibatasi.

  • Mesin Eureka: Layanan Eureka yang dikelola MSE telah dihentikan. MSE Nacos mendukung protokol Eureka dan kompatibel dengan klien Eureka. Kami menyarankan untuk memigrasikan instans edisi Dasar Eureka Anda ke edisi Profesional atau Developer MSE Nacos.

Dampak peningkatan

  • Peningkatan memerlukan waktu sekitar 10 menit. Selama periode ini, Anda tidak dapat melakukan operasi apa pun terhadap instans di konsol. Kami menyarankan melakukan peningkatan pada jam sepi untuk menghindari gangguan terhadap layanan Anda.

  • Untuk instans dengan tiga node atau lebih, peningkatan menggunakan penyebaran bergulir di seluruh node dengan sinkronisasi data otomatis, sehingga menjamin peningkatan tanpa downtime.

  • Bagi sebagian besar layanan, peningkatan bersifat lossless. Namun, rekoneksi jaringan selama peningkatan mungkin menghasilkan beberapa log kesalahan akses dan rekoneksi. Ini merupakan perilaku yang diharapkan. Data pemantauan juga mungkin menunjukkan fluktuasi singkat akibat restart kluster.

  • Pada beberapa skenario khusus, peningkatan lossless tidak dapat dijamin. Sebelum melakukan peningkatan, periksa kondisi berikut:

    • Instans dengan satu atau dua node bukanlah instans high availability (HA), sehingga peningkatan akan menyebabkan downtime.

    • Jika Anda menggunakan versi klien lama, terdapat probabilitas sangat rendah bahwa kehilangan paket atau anomali tak dikenal lainnya selama peningkatan dapat memicu bug klien, menyebabkan layanan Anda offline. Dalam kasus ini, peningkatan akan menyebabkan downtime.

    • Jika Anda menggunakan versi Spring Cloud Alibaba yang lebih lama dan telah mengonfigurasi path pemeriksaan kesehatan Spring Cloud Actuator sebagai probe liveness atau readiness untuk layanan Anda, karena bug pada versi Spring Cloud Alibaba lama, terdapat probabilitas sangat rendah bahwa kegagalan probe dapat menyebabkan aplikasi Anda restart secara otomatis. Dalam kasus ini, peningkatan akan menyebabkan downtime.

  • Saat meningkatkan dari mesin Eureka ke edisi Profesional atau Developer Nacos:

    • Anda tidak perlu mengubah kode aplikasi Anda.

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

    • Secara default, instans edisi Dasar Eureka dimigrasikan ke edisi Developer atau Profesional Nacos dengan versi mesin 2.1.2.2. Anda dapat meningkatkan ke versi Nacos terbaru di kemudian hari. Untuk informasi lebih lanjut, lihat Tingkatkan versi mesin Nacos.

Jalur peningkatan

Anda hanya dapat meningkatkan dari edisi Dasar ke edisi Profesional atau Developer jika mesin Nacos Anda berada pada versi 1.2.1.0 atau lebih baru. Jika Anda menggunakan versi 1.1.3.x, Anda harus terlebih dahulu meningkatkan mesin ke versi 1.2.1. Untuk petunjuknya, lihat Tingkatkan versi mesin Nacos.

Tingkatkan versi mesin Nacos

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

  • Anda tidak dapat melakukan rollback versi dari konsol setelah peningkatan. 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 peningkatan dari konsol dengan salah satu dari dua cara berikut:

    Catatan

    Jika instans target sudah berada pada versi terbaru, opsi Manual Upgrade tidak 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 ditingkatkan. Di halaman Basic Information, klik Manual Upgrade di samping Engine Version.

  4. Pada kotak dialog Cluster Upgrade, klik OK.

Tingkatkan edisi dasar Nacos/Eureka

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

  2. Pada 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. Pada halaman pengubahan 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 ditingkatkan ke Developer Edition atau Professional Edition.

    • Instans Developer Edition hanya dapat ditingkatkan ke versi Developer Edition yang lebih baru. Instans tersebut tidak dapat ditingkatkan ke Professional Edition.

    • Instans Professional Edition hanya dapat ditingkatkan ke versi Professional Edition yang lebih baru. Instans tersebut tidak dapat diturunkan 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 lama?

Pusat konfigurasi kompatibel dengan Nacos client 1.0.0 dan versi lebih baru. Service discovery kompatibel dengan Nacos client 1.2.0 dan versi lebih baru. Klien Nacos 1.x.x tidak mendukung koneksi persisten, sehingga kami menyarankan menggunakan Nacos client 2.0.0 atau versi lebih baru.

T: Bagaimana cara melakukan peningkatan klien Spring Cloud Alibaba atau Dubbo?

Spring Cloud Alibaba

Untuk meningkatkan klien Nacos untuk Spring Cloud Alibaba, tentukan dalam 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 meningkatkan klien Nacos untuk Dubbo, tentukan dalam dependensi Anda:

Penting

Versi Dubbo 2.7.8 memiliki bug kritis yang membuat banyak instans klien Nacos, menyebabkan lonjakan koneksi dan thread. Tingkatkan versi Dubbo Anda sebelum meningkatkan klien Nacos. Untuk informasi lebih lanjut, 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>

Kesalahan setelah peningkatan

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

  • Gejala: Setelah Anda meningkatkan instans MSE ke edisi Profesional dan memperbarui klien Nacos di aplikasi Anda, aplikasi gagal memulai dan melaporkan kesalahan 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 atur ke 8848. Klien Nacos secara otomatis menghitung port gRPC yang benar.

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

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

  • Penyebab: Edisi Profesional MSE melakukan doublewrite untuk menyinkronkan data antara versi lama dan baru serta memastikan konsistensi. Selama proses ini, MSE sementara menolak permintaan dari klien Nacos 2.0.0. Permintaan dari klien Nacos 1.x.x dan operasi konsol tidak terpengaruh. Alih bencana selesai secara otomatis, biasanya dalam 5 hingga 20 menit tergantung ukuran instans.

  • Saran: Tunggu beberapa menit lalu restart aplikasi Anda.