Microservices Engine:空のリスト保護

制限事項

1.4.1 以降の Nacos Java クライアントは、空のリスト保護をサポートしています。

手順

• Nacos Java クライアントを使用する場合は、次の操作を実行します。

  1. 次の Nacos クライアント の依存関係を追加します。

     <!-- ${nacos-client.version} は 1.4.1 以降である必要があります。 -->
     <dependency>
         <groupId>com.alibaba.nacos</groupId>
         <artifactId>nacos-client</artifactId>
         <version>${nacos-client.version}</version>
     </dependency>

  2. アプリケーションコードで次の設定を構成します。

     Properties properties = new Properties();
     properties.put(PropertyKeyConst.SERVER_ADDR, "${MSE Nacos インスタンスのエンドポイント}"); // エンドポイントを設定
     properties.put(PropertyKeyConst.NAMING_PUSH_EMPTY_PROTECTION, "true"); // 空のリスト保護を有効にする
     NamingService naming = NamingFactory.createNamingService(properties);

• アプリケーションが Spring Cloud Alibaba アプリケーションの場合は、アプリケーションの構成ファイルに次の構成を追加します。

  spring.cloud.nacos.discovery.namingPushEmptyProtection=true

• アプリケーションが Dubbo アプリケーションの場合は、Dubbo アプリケーションの構成ファイルに次のレジストリ URL 構成を追加します。

  dubbo.registry.address=nacos://${MSE Nacos インスタンスのエンドポイント}:8848?namingPushEmptyProtection=true

制限事項

Nacos エンジンバージョンは 2.1.0.0 以降である必要があります。 Nacos エンジンバージョンのアップグレード方法の詳細については、Nacos バージョンの更新 をご参照ください。

手順

空のリスト保護を有効にする方法は、MSE Nacos エンジンのバージョンによって異なります。

• MSE Nacos エンジンのバージョンが 2.1.0.0 または 2.1.0.1 の場合、操作は必要ありません。これらのバージョンでは、空のリスト保護が自動的に有効になります。

• MSE Nacos エンジンのバージョンが 2.1.0.2 以降の場合は、次の手順を実行して空のリスト保護を有効にします。

  1. MSE コンソール にログインし、上部のナビゲーションバーでリージョンを選択します。

  2. 左側のナビゲーションペインで、マイクロサービスの登録 > インスタンス を選択します。

  3. インスタンス ページで、インスタンスの名前をクリックします。

  4. 左側のナビゲーションペインで、Parameter Settings をクリックします。 Parameter Settings ページの Real-time Effective Parameters セクションで、forcePushEmptyProtectionForAllService パラメーターの 操作 列の Edit をクリックします。

  5. Edit Parameters ダイアログボックスで、Value に Yes を選択し、OK をクリックします。

     説明

     最高のサービス可用性を確保するために、すべての場合において forcePushEmptyProtectionForAllService パラメーターの Value に Yes を選択することをお勧めします。

結果の確認

サービスが空リスト保護をトリガーすると、コンシューマーが存在するノードの ${user.home}/logs/nacos ディレクトリにある naming.log ファイルに /* サービスの空のプッシュ保護をトリガーする */ と表示されます。

通常、このような情報は頻繁に表示されません。このような情報が頻繁に表示される場合は、次の考えられる原因に基づいてこの問題のトラブルシューティングを行うことができます。

• コンシューマーがサブスクライブしているプロバイダーが存在しません。

  コンシューマーが既存ではないプロバイダーにサブスクライブしている場合は、アプリケーションの依存関係が必要かどうかを確認する必要があります。アプリケーションの依存関係が必要ない場合は、無効な依存関係を削除します。アプリケーションの依存関係が必要な場合は、プロバイダーを再公開する必要があります。

• インスタンスリストにプロバイダーが表示されません。

  • コンシューマーがサブスクライブしているプロバイダーが頻繁に切断されているかどうかを確認します。

  • 各プロバイダーと MSE Nacos インスタンス間のネットワーク接続が正常かどうかを確認します。ネットワーク接続が異常な場合、MSE Nacos インスタンスはプロバイダーが切断されていると判断します。

空のリスト保護をトリガーするサービスの特定

エラーメッセージには、空のリスト保護をトリガーしたサービスに関する情報が含まれています。Service{namespace='XXX', group='xx', name='xxxxxxx', ephemeral=true, revision=0} に基づいて、コンシューマーがサブスクライブしている空のサービスを特定できます。

既知のトリガーシナリオ

空のリスト保護が強制的に有効になるシナリオ

MSE Nacos 2.1.0.2 以降では、空のリスト保護を有効にするロジックが最適化されています。この最適化により、forcePushEmptyProtectionForAllService パラメーターの値に [はい] が選択されている場合にのみ、空のリスト保護が有効になります。ただし、forcePushEmptyProtectionForAllService パラメーターの値に [いいえ] が選択されている場合でも、次のシナリオでは、可用性と安定性を確保するために、システムは引き続き自動的に空のリスト保護を有効にします。

• エンジンノードがアップグレード、再起動、または障害から回復した場合、ノードはすべてのアプリケーションに対して 2 分間の空のリスト保護を自動的に有効にして、その期間中のサービスの可用性を確保します。

• アプリケーションのすべてのインスタンスが MSE インスタンスのアプリケーションインスタンスリストから削除された場合、MSE インスタンスはアプリケーションに対して 1 分間の空のリスト保護を自動的に有効にします。この操作により、ネットワークパフォーマンスの不安定化やサービスプロバイダーの一時的な障害などの問題が発生した場合に、空のリスト保護が予期せずトリガーされるのを防ぎます。このようにして、このシナリオでサービスの可用性が提供されます。