All Products
Search
Document Center

Microservices Engine:Buat konfigurasi

Last Updated:Mar 11, 2026

Konfigurasi Nacos memungkinkan Anda mengeksternalisasi pengaturan aplikasi—seperti fitur flags, kolam koneksi, dan tingkat log—sehingga dapat diperbarui saat waktu proses tanpa perlu menerapkan ulang kode. Setiap konfigurasi diidentifikasi oleh kombinasi unik dari Data ID, Group, dan Namespace.

Prasyarat

Sebelum memulai, pastikan Anda telah:

  • Memiliki subscription MSE yang aktif (aktifkan MSE)

  • Memiliki instans MSE Nacos yang menjalankan Nacos 1.2.1 atau versi lebih baru (Buat engine Nacos)

Buat konfigurasi di Konsol

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

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

  3. Pada halaman Instances, klik nama instans tersebut.

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

  5. Pada halaman Configurations, pilih namespace dari daftar drop-down Namespace di pojok kiri atas, lalu klik Add Configuration.

  6. Pada panel Add Configuration, atur parameter berikut, lalu klik Release.

    ParameterWajibDeskripsi
    Region--Diisi otomatis dari instans Nacos saat ini. Tidak dapat diubah.
    Namespace--Diisi otomatis dari namespace yang dipilih pada langkah 5. Tidak dapat diubah.
    Data IDYaPengidentifikasi unik untuk konfigurasi dalam grupnya. Gunakan konvensi penamaan package.class, seperti com.foo.bar.log.level.
    GroupYaPengelompokan logis untuk konfigurasi terkait. Gunakan nama produk atau nama modul, seperti order-service atau payment-module. Harus unik.
    Data EncryptionTidakMengenkripsi konten konfigurasi untuk melindungi nilai sensitif seperti kredensial database. Saat diaktifkan, Data ID secara otomatis diberi awalan cipher-. Untuk informasi selengkapnya, lihat Konfigurasikan enkripsi.
    Configuration FormatYaFormat data: Properties, JSON, YAML, XML, atau teks biasa.
    DescriptionTidakCatatan singkat yang menjelaskan tujuan konfigurasi ini.
    More Settings > ApplicationTidakAplikasi yang menggunakan konfigurasi ini.
    More Settings > Configuration TagTidakTag untuk memfilter dan mengelola konfigurasi. Ketik kata kunci dan pilih dari daftar drop-down.
    Configuration ContentYaData konfigurasi, dimasukkan di panel kanan. Contohnya: threadPoolSize=5 dan logLevel=WARN.

Setelah Anda mengklik Release, konfigurasi akan muncul di halaman Configurations.

Contoh konten konfigurasi

Pengaturan aplikasi (format Properties)

# Kolam koneksi database
db.pool.maxActive=20
db.pool.minIdle=5
db.pool.maxWait=60000

# Pencatatan log
log.level=WARN
log.path=/var/log/app

Fitur flags (format JSON)

{
  "features": {
    "new_checkout_flow": {
      "enabled": true,
      "rollout_percentage": 25
    },
    "dark_mode": {
      "enabled": false
    }
  }
}

Konfigurasi titik akhir layanan (format YAML)

upstream:
  payment-service:
    url: https://pay.example.com/api/v2
    timeout: 3000
    retries: 3
  inventory-service:
    url: https://inv.example.com/api/v1
    timeout: 5000
    retries: 2

Batasan

Jenis konfigurasiUkuran maksimum
Non-terenkripsi100 KB
Terenkripsi50 KB

Jika ukuran konfigurasi melebihi batas ini, pisahkan menjadi beberapa konfigurasi yang lebih kecil. Untuk meminta kuota yang lebih besar, buka Quota Center.

Penting

Mengubah batas ukuran konten dapat memengaruhi stabilitas Nacos. Evaluasi dampaknya sebelum mengajukan permintaan penyesuaian kuota.