このトピックでは、暗号化された構成を使用できない問題のトラブルシューティング方法について説明します。
問題の説明
以下のシナリオで暗号化された構成をリリースできない場合は、このトピックで説明されているソリューションに基づいて問題を解決できます。
Spring Cloud Alibabaと暗号化および復号化された構成に基づいてビジネスアプリケーションが開発されています。ビジネスアプリケーションを起動できません。
Java 用のネイティブ Nacos SDK と暗号化および復号化された構成に基づいてビジネスアプリケーションが開発されています。暗号化および復号化された構成をリリースまたはクエリできません。
Go 用 Nacos SDK や Node.js 用 Nacos SDK など、Java 以外のプログラミング言語用の Nacos SDK に基づいてビジネスアプリケーションが開発されています。暗号化および復号化された構成を使用できません。
MSE コンソールで暗号化および復号化された構成がリリースされると、エラーが報告されます。
考えられる原因
ネットワーク接続または特殊文字に関連する問題が発生する可能性があります。問題の解決方法の詳細については、「Nacos クライアントを使用して構成をリリースできない場合はどうすればよいですか？」をご参照ください。
問題が解決しない場合は、以下の情報に基づいて適切なソリューションを入手できます。
Spring Cloud Alibaba
Spring Cloud Alibaba と暗号化および復号化された構成に基づいてビジネスアプリケーションを開発し、ビジネスアプリケーションを起動できない場合、問題は次の原因が考えられます。
ビジネスアプリケーションの
dataId、groupId、および tenantIdパラメーターを MSE の暗号化および復号化パラメーターにマッピングできません。暗号化および復号化プラグインの依存関係がビジネスリポジトリに含まれていません。詳細については、暗号化および復号化プラグインのリポジトリにアクセスしてください。
Key Management Service（KMS）サービスがアクティブ化されていません。
認証に失敗しました。関連する権限が付与されていません。
Java 用ネイティブ Nacos SDK
Java 用のネイティブ Nacos SDK と暗号化および復号化された構成に基づいてビジネスアプリケーションを開発し、ビジネスアプリケーションを起動できない場合、問題は次の原因が考えられます。
ビジネスアプリケーションの
dataId、groupId、および tenantIdパラメーターを MSE の暗号化および復号化パラメーターにマッピングできません。暗号化および復号化プラグインの依存関係がビジネスリポジトリに含まれていません。詳細については、暗号化および復号化プラグインのリポジトリにアクセスしてください。
Alibaba Cloud 製品ページで KMS サービスがアクティブ化されていません。
認証に失敗しました。関連する権限が付与されていません。
Java 以外のプログラミング言語用 Nacos SDK
Go 用 Nacos SDK や Node.js 用 Nacos SDK など、Java 以外のプログラミング言語用の Nacos SDK に基づいてビジネスアプリケーションを開発し、暗号化および復号化された構成を使用できない場合、問題は次の原因が考えられます。
Java 以外のプログラミング言語用 Nacos SDK では、暗号化および復号化された構成をリリースまたはクエリできません。
ビジネスアプリケーションの
dataId、groupId、および tenantIdパラメーターを MSE の暗号化および復号化パラメーターにマッピングできません。Alibaba Cloud 製品ページで KMS サービスがアクティブ化されていません。
認証に失敗しました。関連する権限が付与されていません。
MSE コンソール
MSE コンソールで暗号化および復号化された構成をリリースするときにエラーメッセージが表示される場合、問題は次の原因が考えられます。
構成の内容に特殊文字が含まれています。問題の解決方法の詳細については、「Nacos クライアントを使用して構成をリリースできない場合はどうすればよいですか？」をご参照ください。
Alibaba Cloud 製品ページで KMS サービスがアクティブ化されていません。
認証に失敗しました。関連する権限が付与されていません。
ソリューション
ネットワーク接続または特殊文字に関連する問題が発生しているかどうかを確認します。問題の解決方法の詳細については、「Nacos クライアントを使用して構成をリリースできない場合はどうすればよいですか？」をご参照ください。
次に、Alibaba Cloud KMS コンソールにログオンし、KMS サービスがアクティブ化されているかどうかを確認します。
問題が解決しない場合は、以下の情報に基づいて適切なソリューションを入手できます。
Spring Cloud Alibaba
Spring Cloud Alibaba または Java 用ネイティブ Nacos SDK に基づいてビジネスアプリケーションを開発する場合は、${user_home}/logs/nacos ディレクトリの config.log ファイルで詳細なエラー情報を確認します。
ログファイルに HTTP ステータスコード 403 が見つかった場合は、関連する権限が付与されていません。問題を解決するには、RAM ユーザーに関連する権限を付与します。詳細については、「Nacos クライアントによるアクセス認証」をご参照ください。
ログ内の
dataId、groupId、tenant、および namespaceIdなどのキーワードが MSE コンソールのキーワードと一致しない場合は、MSE コンソールで構成をリリースします。 ConfigService.publishConfig API オペレーションを呼び出して、構成をリリースすることもできます。問題が解決しない場合は、デモプロジェクトを使用してデバッグします。
Go 用ネイティブ Nacos SDK
Go 用 Nacos SDK に基づいてビジネスアプリケーションを開発する場合は、デモプロジェクトを使用してデバッグします。詳細については、Go 用 Nacos SDK の暗号化および復号化デモリポジトリにアクセスしてください。
Java 以外のプログラミング言語用 Nacos SDK
Go API を除く Java 以外の API は、暗号化および復号化された構成をサポートしていません。前述の問題に関連するソリューションを提供する場合は、GitHub にアクセスしてエンジニアリングコードを見つけ、貢献することができます。
MSE コンソール
MSE コンソールで暗号化および復号化された構成をリリースできない場合は、構成サイズが 50 KB を超えているかどうかを確認します。構成サイズが 50 KB を超えると、暗号化および復号化された構成によって不安定性の問題が発生する可能性があります。これらの問題を防ぐために、暗号化および復号化された構成を分割します。