Microservices Engine (MSE) memungkinkan Anda mengelola layanan yang terdaftar di instans Nacos melalui Konsol. Anda dapat membuat dan menghapus layanan, menambahkan instans aplikasi (provider), mengaktifkan atau menonaktifkan instans, serta memantau subscriber dan pelacakan push.
Prasyarat
Sebelum memulai, pastikan Anda telah:
Membuat engine Nacos yang menjalankan versi 2.0.3.0 atau lebih baru. Jika engine Anda menjalankan versi sebelumnya, upgrade terlebih dahulu.
Navigasi ke halaman layanan
Semua operasi pengelolaan layanan dimulai dari halaman yang sama. Selesaikan langkah-langkah berikut terlebih dahulu, lalu ikuti instruksi spesifik tugas di setiap bagian.
Masuk ke Konsol MSE dan pilih wilayah di bilah navigasi atas.
Di panel navigasi kiri, pilih Microservices Registry > Instances.
Pada halaman Instances, klik nama instans tersebut.
Di panel navigasi kiri, pilih Service Management > Services. Pilih namespace dari daftar drop-down Namespace.
Buat layanan
Buat layanan kosong untuk mendefinisikan atau menguji layanan sebelum provider mendaftar ke dalamnya. Layanan kosong tidak memiliki provider. Untuk menampilkan layanan kosong dalam daftar layanan, aktifkan Show Empty Service.
Setelah Anda menavigasi ke halaman layanan:
Klik Create service.
Pada panel Create service, konfigurasikan parameter berikut, lalu klik OK.
Parameter untuk Nacos 2.1.2.1 atau lebih baru
| Parameter | Wajib | Tipe | Bawaan | Deskripsi |
|---|---|---|---|---|
| Service Name | Ya | String | -- | Nama layanan. |
| Group Name | Ya | String | -- | Grup tempat layanan tersebut berada. |
| Instance Source | Ya | Enum | -- | Sumber instans. Nilai yang valid: Console, SDK. |
| Protection Threshold | Ya | Float | -- | Rasio minimum instans sehat untuk mencegah gangguan sistem. Nilai yang valid: 0 hingga 1. Lihat panduan ambang batas perlindungan. |
Parameter untuk Nacos 2.0.3.0 hingga 2.1.2.0
| Parameter | Wajib | Tipe | Bawaan | Deskripsi |
|---|---|---|---|---|
| Service Name | Ya | String | -- | Nama layanan. |
| Group Name | Ya | String | -- | Grup tempat layanan tersebut berada. |
| Persistence | Ya | Boolean | -- | Apakah layanan dan instansnya dipertahankan (persisted). |
| Protection Threshold | Ya | Float | 0 | Rasio instans sehat di bawah ambang batas mana mekanisme perlindungan diaktifkan. Nilai yang valid: 0 hingga 1. Untuk informasi selengkapnya, lihat Implement high availability capabilities of MSE Microservices Registry. |
Panduan ambang batas perlindungan
Tetapkan ambang batas perlindungan sebagai proporsi jumlah minimum node yang mampu memproses trafik maksimum. Misalnya, jika tersedia 10 node instans dan minimal 6 node mampu memproses trafik maksimum, tetapkan nilai ini menjadi 0.6.
Hapus layanan
Hanya layanan persisten tanpa provider yang dapat dihapus. Jika layanan masih memiliki provider (kolom Number of providers tidak bernilai 0), tombol Delete akan diredupkan.
Layanan persisten bukanlah layanan temporary. Jika suatu layanan tetap kosong selama lebih dari 1 menit, instans Nacos akan secara otomatis menghapus layanan tersebut.
Setelah Anda menavigasi ke halaman layanan:
Temukan layanan yang dituju, klik More pada kolom Actions, lalu pilih Delete.
Pada kotak dialog konfirmasi, klik OK.
Lihat detail layanan
Daftar layanan menampilkan kolom-kolom berikut untuk setiap layanan:
| Kolom | Deskripsi |
|---|---|
| Service Name | Nama layanan. |
| Group Name | Grup tempat layanan tersebut berada. |
| Number of providers | Jumlah instans aplikasi yang menyediakan layanan tersebut. |
| Number of Clusters | Jumlah kluster logis. |
Setelah Anda menavigasi ke halaman layanan, klik nama layanan untuk membuka halaman detailnya. Bagian atas menampilkan nama layanan, grup layanan, status persistence, dan jumlah kluster.
Tab Provider
Menampilkan semua instans aplikasi yang menyediakan layanan ini, dikelompokkan berdasarkan kluster logis. Secara default, kluster logis pertama ditampilkan.
Pada bagian All Clusters di sebelah kiri, klik nama kluster untuk melihat instans dalam kluster tersebut.
Pada kolom Actions untuk setiap instans, ubah bobot, aktifkan atau nonaktifkan instans, hapus instans, atau lihat metadata-nya.
Tab Subscriber
Menampilkan semua klien yang berlangganan ke layanan tersebut, termasuk alamat IP dan versi klien mereka.
Push Track tab
Menampilkan detail pelacakan push untuk layanan tersebut:
| Field | Deskripsi |
|---|---|
| Push Time | Waktu saat push terjadi. |
| Push Client IP Address | Alamat IP klien yang menerima push. |
| Push service name | Nama layanan yang dipush. |
| Push Service Group | Grup layanan dari layanan yang dipush. |
| Number of Instances | Jumlah instans yang disertakan dalam push tersebut. |
| Node name | Nama node yang memulai push tersebut. |
Tambahkan instans aplikasi
Tambahkan instans aplikasi (provider) untuk suatu layanan melalui Konsol MSE guna mendefinisikan atau menguji instans sebelum digunakan secara langsung.
Setelah Anda menavigasi ke halaman layanan:
Klik nama layanan untuk membuka halaman detailnya.
Klik tab Provider, lalu klik Create an instance.
Pada kotak dialog Create an instance, konfigurasikan parameter berikut, lalu klik OK.
| Parameter | Wajib | Tipe | Bawaan | Deskripsi |
|---|---|---|---|---|
| IP | Ya | String | -- | Alamat IP instans aplikasi. |
| Port Number | Ya | Integer | -- | Nomor port instans aplikasi. |
| Cluster Name | Tidak | String | DEFAULT | Kluster logis tempat instans ini berada pada instans Nacos. |
| Up and down line status | Tidak | Boolean | Yes (online) | Status awal online/offline instans tersebut. |
| Weight | Tidak | -- | 1 | Bobot trafik instans tersebut. Nilai yang valid: 0 hingga 10.000. Bobot yang lebih tinggi mengarahkan lebih banyak trafik ke instans tersebut. Jika perubahan bobot tidak berlaku, lihat What do I do if the modified weight of an application instance does not take effect on an MSE Nacos instance? |
Aktifkan atau nonaktifkan instans aplikasi
Aktifkan atau nonaktifkan instans aplikasi yang terdaftar di instans Nacos Anda.
Setelah Anda menavigasi ke halaman layanan:
Klik nama layanan untuk membuka halaman detailnya.
Klik tab Provider. Temukan instans yang dituju, lalu klik On line atau Offline pada kolom Actions.
Pada kotak dialog konfirmasi, klik OK.