Microservices Engine：Perlindungan Daftar Kosong

Batasan

Klien Java Nacos versi 1.4.1 atau lebih baru mendukung perlindungan daftar kosong.

Prosedur

• Jika Anda menggunakan klien Java Nacos, lakukan operasi berikut:

  1. Tambahkan dependensi berikut dari klien Nacos:

     <!-- ${nacos-client.version} harus 1.4.1 atau lebih baru. -->
     <dependency>
         <groupId>com.alibaba.nacos</groupId>
         <artifactId>nacos-client</artifactId>
         <version>${nacos-client.version}</version>
     </dependency>

  2. Konfigurasikan pengaturan berikut dalam kode aplikasi:

     Properties properties = new Properties();
     properties.put(PropertyKeyConst.SERVER_ADDR, "${Endpoint dari instance MSE Nacos}");
     properties.put(PropertyKeyConst.NAMING_PUSH_EMPTY_PROTECTION, "true");
     NamingService naming = NamingFactory.createNamingService(properties);

• Jika aplikasi Anda adalah aplikasi Spring Cloud Alibaba, tambahkan konfigurasi berikut ke file konfigurasi aplikasi Anda:

  spring.cloud.nacos.discovery.namingPushEmptyProtection=true

• Jika aplikasi Anda adalah aplikasi Dubbo, tambahkan konfigurasi URL registri berikut ke file konfigurasi aplikasi Dubbo Anda:

  dubbo.registry.address=nacos://${Endpoint dari instance MSE Nacos}:8848?namingPushEmptyProtection=true

Batasan

Versi mesin Nacos harus 2.1.0.0 atau lebih baru. Untuk informasi lebih lanjut tentang cara memperbarui versi mesin Nacos, lihat Perbarui versi Nacos.

Prosedur

Metode untuk mengaktifkan perlindungan daftar kosong bervariasi berdasarkan versi mesin MSE Nacos Anda.

• Jika versi mesin MSE Nacos Anda adalah 2.1.0.0 atau 2.1.0.1, tidak diperlukan tindakan apa pun. Perlindungan daftar kosong secara otomatis diaktifkan dalam versi ini.

• Jika versi mesin MSE Nacos Anda adalah 2.1.0.2 atau lebih baru, lakukan langkah-langkah berikut untuk mengaktifkan perlindungan daftar kosong:

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

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

  3. Di halaman Instances, klik nama instance tersebut.

  4. Di panel navigasi kiri, klik Parameter Settings. Di bagian Real-time Effective Parameters pada halaman Parameter Settings, klik Edit di kolom Actions dari parameter forcePushEmptyProtectionForAllService.

  5. Di kotak dialog Edit Parameters, pilih Yes untuk Value dan klik OK.

     Catatan

     Untuk memastikan ketersediaan layanan tertinggi, kami menyarankan Anda memilih Yes untuk Value dari parameter forcePushEmptyProtectionForAllService dalam semua kasus.

Verifikasi hasil

Saat layanan memicu perlindungan daftar kosong, Trigger push empty protection for Service ditampilkan di file naming.log di direktori ${user.home}/logs/nacos node tempat konsumen berada.

Dalam kondisi normal, informasi semacam itu tidak sering muncul. Jika informasi tersebut sering muncul, Anda dapat menyelesaikan masalah ini berdasarkan penyebab potensial berikut:

• Penyedia yang dilanggan oleh konsumen tidak ada.

  Jika konsumen berlangganan ke penyedia yang tidak ada, Anda harus memeriksa apakah ketergantungan aplikasi diperlukan. Jika ketergantungan aplikasi tidak diperlukan, hapus ketergantungan yang tidak valid. Jika ketergantungan aplikasi diperlukan, Anda harus menerbitkan kembali penyedia tersebut.

• Tidak ada penyedia yang ditampilkan dalam daftar instance.

  • Periksa apakah penyedia yang dilanggan oleh konsumen sering terputus.

  • Periksa apakah koneksi jaringan antara setiap penyedia dan instance MSE Nacos normal. Jika koneksi jaringan abnormal, instance MSE Nacos menentukan bahwa penyedia terputus.

Identifikasi layanan yang memicu perlindungan daftar kosong

Pesan kesalahan berisi informasi tentang layanan yang memicu perlindungan daftar kosong. Anda dapat mengidentifikasi layanan kosong yang dilanggan oleh konsumen berdasarkan Service{namespace='XXX', group='xx', name='xxxxxxx', ephemeral=true, revision=0}.

Skenario pemicu yang diketahui

Skenario di mana perlindungan daftar kosong diaktifkan secara paksa

Dalam MSE Nacos 2.1.0.2 atau lebih baru, logika untuk mengaktifkan perlindungan daftar kosong dioptimalkan. Optimasi ini memastikan bahwa perlindungan daftar kosong diaktifkan hanya jika Yes dipilih untuk Value dari parameter forcePushEmptyProtectionForAllService. Namun, sistem masih secara otomatis mengaktifkan perlindungan daftar kosong untuk memastikan ketersediaan dan stabilitas dalam skenario berikut meskipun No dipilih untuk Value dari parameter forcePushEmptyProtectionForAllService.

• Saat node mesin ditingkatkan, di-restart, atau pulih dari kegagalan, node secara otomatis mengaktifkan perlindungan daftar kosong selama dua menit untuk semua aplikasi guna memastikan ketersediaan layanan selama periode waktu tersebut.

• Jika semua instance aplikasi dihapus dari daftar instance aplikasi pada instance MSE, instance MSE secara otomatis mengaktifkan perlindungan daftar kosong selama satu menit untuk aplikasi tersebut. Operasi ini mencegah perlindungan daftar kosong dipicu secara tidak terduga ketika masalah seperti performa jaringan yang tidak stabil dan kegagalan sementara penyedia layanan terjadi. Dengan cara ini, ketersediaan layanan disediakan dalam skenario ini.