All Products
Search

This Product

    Microservices Engine:Integrasikan MSE Nacos sebagai pusat konfigurasi

    Document Center

    Microservices Engine:Integrasikan MSE Nacos sebagai pusat konfigurasi

    Last Updated:Jun 22, 2026

    Topik ini menjelaskan cara mengintegrasikan pusat konfigurasi MSE Nacos dengan aplikasi Spring Cloud Anda untuk manajemen konfigurasi terpusat dan penyegaran dinamis.

    Informasi latar belakang

    Dalam arsitektur layanan mikro, mengelola konfigurasi melalui nilai yang di-hardcode atau file statis sangat sulit, terutama saat jumlah layanan mikro dan lingkungan semakin bertambah. Pendekatan ini sering menyebabkan ketidakkonsistenan konfigurasi serta keterlambatan pembaruan. Pusat konfigurasi mengatasi masalah tersebut dengan menyediakan tempat terpusat untuk menyimpan, mengelola, dan memperbarui data konfigurasi secara dinamis. Hal ini menjamin isolasi konfigurasi dan sinkronisasi antar berbagai lingkungan dan instans, sekaligus meningkatkan fleksibilitas serta keamanan dalam pembaruan konfigurasi.

    Prasyarat

    • Unduh Maven dan siapkan variabel lingkungan yang diperlukan.

    • Aplikasi Spring Cloud yang sudah ada. Jika belum memiliki, Anda dapat menggunakan aplikasi demo yang disediakan dalam topik ini: nacos-service-config.zip.

    • Buat engine Nacos.

      Penting

      Jika aplikasi Anda tidak berada di wilayah yang sama dengan MSE Nacos atau tidak berjalan di server Alibaba Cloud, pilih jaringan publik saat membuat engine Nacos.

      Untuk memastikan aplikasi Anda dapat mengakses MSE melalui jaringan publik, konfigurasikan daftar putih. Untuk informasi selengkapnya, lihat Setel daftar putih.

    • Buat namespace.

    Ikhtisar

    Dengan mengintegrasikan pusat konfigurasi MSE Nacos ke aplikasi Spring Cloud, Anda dapat mencoba fitur penyegaran dinamisnya dengan memublikasikan parameter konfigurasi useLocalCache=true, memperbaruinya menjadi useLocalCache=false di Konsol MSE Nacos, lalu meminta API konfigurasi aplikasi dari command line untuk mengambil nilai useLocalCache dan mengamati perubahannya.

    1. Buat dan publikasikan konfigurasi: Tentukan dan publikasikan pengaturan konfigurasi awal di Konsol MSE.

    2. Integrasikan MSE Nacos: Tambahkan dependensi dan properti yang diperlukan untuk menghubungkan aplikasi Spring Cloud Anda ke pusat konfigurasi MSE Nacos.

    3. Verifikasi penyegaran dinamis: Ubah konfigurasi di Konsol dan pastikan aplikasi menerapkan perubahan tersebut tanpa perlu restart.

    Langkah 1: Buat dan publikasikan konfigurasi

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

    2. Klik nama instans target.

    3. Di panel navigasi kiri, pilih Configuration Management > Configurations.

    4. Di atas daftar konfigurasi, pilih namespace yang telah Anda buat.

    5. Klik Add Configuration. Di panel Add Configuration, masukkan informasi berikut:

      Catatan

      Topik ini hanya menyediakan contoh konfigurasi sebagai referensi. Anda dapat membuat konfigurasi sesuai kebutuhan bisnis Anda. Untuk informasi lebih lanjut tentang parameter tersebut, lihat Buat konfigurasi.

      Atur Data ID menjadi mse-nacos-config-client.properties dan Group menjadi DEFAULT_GROUP. Untuk Configuration Format, pilih Properties. Di bidang Configuration Content, masukkan useLocalCache=true, lalu klik Publish.

    1. Setelah memasukkan detail konfigurasi, klik Publish. Konfigurasi baru akan muncul di daftar Configurations.

    Langkah 2: Integrasikan MSE Nacos

    1. (Opsional) Jika belum membuat aplikasi Spring Cloud, Anda dapat menggunakan contoh ini untuk menyiapkan aplikasi sederhana dengan cepat.

    2. Tambahkan dependensi untuk pusat konfigurasi Nacos ke file pom.xml aplikasi Spring Cloud Anda:

      Catatan

      Versi Spring Cloud Alibaba, Spring Cloud, dan SpringBoot harus kompatibel. Periksa catatan rilis versi di situs resmi Spring Cloud Alibaba untuk memilih versi yang kompatibel bagi aplikasi Anda. Disarankan untuk melakukan upgrade ke versi terbaru 2023.x.

              <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
            <version>2021.0.4.0</version>
        </dependency>

    3. Tambahkan pengaturan terkait Nacos ke file konfigurasi aplikasi Spring Cloud Anda:

      Penting

      Untuk menggunakan namespace tertentu di aplikasi Anda, berikan ID-nya.

      # Titik akhir publik server Nacos Anda.
spring.cloud.nacos.config.server-addr=mse-XXX.nacos-ans.mse.aliyuncs.com:8848
# Tentukan namespace MSE Nacos. Untuk mengakses namespace publik default, biarkan kosong atau jangan konfigurasi item ini.
spring.cloud.nacos.config.namespace=24075300-XXXX-XXXX-XXXX-0c17aa9f744b
# Impor file konfigurasi tertentu.
spring.config.import=nacos:mse-nacos-config-client.properties?group=DEFAULT_GROUP&refreshEnabled=true

      Di halaman Instances, Anda dapat menemukan titik akhir publik MSE Nacos. Formatnya adalah mse.XX.nacos.mse.aliyuncs.com.

    4. Setelah melakukan perubahan, jalankan perintah mvn clean package untuk mengompilasi ulang dan membuat paket aplikasi.

    Langkah 3: Verifikasi penyegaran dinamis

    Catatan

    Langkah verifikasi berikut didasarkan pada contoh aplikasi Spring Cloud dan konfigurasi yang disediakan dalam topik ini. Jika Anda menggunakan aplikasi sendiri atau konfigurasi khusus, Anda mungkin perlu menyesuaikan langkah-langkah ini.

    1. Jalankan aplikasi Spring Cloud dengan menjalankan fungsi utama di kelas startup.

    2. Di terminal Anda, jalankan perintah berikut untuk mendapatkan konfigurasi useLocalCache dari pusat konfigurasi MSE Nacos. Responsnya adalah true.

      # Ganti dengan alamat IP dan port layanan Anda.
curl http://<your-service-ip>:18083/getConfig

    3. Di Konsol, edit konfigurasi, ubah isinya menjadi useLocalCache=false, lalu publikasikan kembali.

    4. Jalankan perintah tersebut lagi. Responsnya sekarang adalah false. Hal ini mengonfirmasi bahwa aplikasi telah mengambil data useLocalCache terbaru dari MSE Nacos tanpa perlu restart.

    Dokumen terkait