カスタムプラグインのインストールエラーのトラブルシューティング
Alibaba Cloud Elasticsearch へのカスタムプラグインのインストールは、コンソールで報告されるエラー、クラスター更新の一時停止、または検証失敗によって失敗することがあります。本トピックでは、各タイプの失敗の原因を特定し、解決する方法について説明します。
インストール前の確認事項
カスタムプラグインをアップロードする前に、以下の制約事項をご確認ください。これらの制約に違反することは、インストール失敗の最も一般的な原因です。
サイズ制限：プラグインパッケージは 50 MB 未満である必要があります。それより大きなパッケージは読み込みが遅く、クラスター更新の一時停止を引き起こします。
重複する名前を避ける：カスタムプラグインは、Alibaba Cloud Elasticsearch の組み込みプラグインと同一の名前を使用できません。アップロード前にプラグイン名を変更してください。
事前にセルフマネージドクラスターでテスト：すべてのカスタムプラグインは、Alibaba Cloud Elasticsearch へアップロードする前に、ローカル環境でのインストールテストを通過する必要があります。以下のコマンドでテストを行ってください：
./bin/elasticsearch-plugin install file:///path-to-your-plugins.zipプラグインパッケージを、ご利用のセルフマネージド Elasticsearch クラスターのインストールパス直下の
pluginsディレクトリに配置し、クラスターを再起動した後、以下のコマンドを実行してプラグインの読み込みを確認します：GET /_cat/plugins?vローリングアップデート不可：カスタムプラグインにはローリングアップデート機能は利用できません。
セキュリティポリシーの制限：追加、削除、変更、および照会の権限（例：
elasticsearch-analysis-hanlp）を定義するセキュリティポリシーを持つプラグインはアップロードできません。Logstash および Kibana：カスタムプラグインは Logstash や Kibana に対して直接インストールできません。ネイティブなインストールコマンドを用いてセルフマネージドクラスターでプラグインをテストした後、チケットを送信 して、Alibaba Cloud Elasticsearch のテクニカルサポートまでお問い合わせください。
プラグインのインストールが正常に完了した後は、Alibaba Cloud Elasticsearch コンソールの クラスターログ タブでそのログを確認できます。
コンソールで報告されるエラー
原因：プラグインが要件を満たしていないためです。
対処方法：インストール前の確認事項 に記載された制約事項を確認してください。代表的な対応として、プラグイン名の変更や、許可されていない権限を削除するための構成ファイルの修正があります。
クラスター更新の一時停止
プラグインのインストール後にクラスター更新が一時停止した場合は、以下の点を確認してください。
プラグインのサイズを確認します。 パッケージサイズが 50 MB 以上の場合、インストールを中止し、プラグインを削除してサイズを縮小してください（不要なトークン辞書の削除など）。サイズを 50 MB 未満にした後、再アップロードおよび再インストールを行います。
クラスターがデータ書き込み中かどうかを確認します。 クエリを実行して、データノードがアクティブかどうかを確認します。
データが書き込まれている場合：数分間待機してください。ピーク時のインストールは遅くなるため、自動的に完了します。
データが書き込まれていない場合：インストールを中止し、プラグインを削除した後、セルフマネージドクラスターで再度テストしてから再アップロードしてください。
検証失敗
以下に、一般的な検証エラー、その原因、および対処方法をまとめた表を示します。
| エラー | 原因 | 修正 |
|---|---|---|
| Elasticsearch のバージョン不一致 | プラグイン記述子に記載された Elasticsearch バージョンが、ご利用の Alibaba Cloud Elasticsearch クラスターのバージョンと一致していません。 | プラグイン記述子内のバージョンを、クラスターのバージョンと完全に一致するように更新してください（例：7.10.1）。Jieba のようなプラグインでは、パッチレベルまで正確に一致させる必要があります。その後、再パッケージングを行ってください。詳細については、「よくある質問」をご参照ください。 |
plugin-descriptor.properties が見つかりません | 展開されたパッケージ内に記述子ファイルが存在しません。これは、パッケージング時に余分なディレクトリ階層が作成されたことが原因である場合が多いです。 | パッケージをローカルで解凍し、ディレクトリ構造を確認してください。解凍後に余分なディレクトリ階層が生成されていないかを確認します。JAR ファイルは正しいディレクトリ階層に配置されている必要があり、余分なフォルダ内にネストされてはなりません。構造が不適切な場合は、プラグインを再パッケージングしてください。 |
| 無効なプラグインパッケージ | プラグインが正しくパッケージングされていません。Elasticsearch はソースコードではなくバイナリを期待しています。 | 以下のいずれかの方法で再パッケージングを行ってください。WinRAR：JAR ファイルを右クリックし、アーカイブに追加 を選択し、フォーマットを ZIP に設定し、アーカイブ名を elasticsearch から始めてバージョンを含めるようにします（例：elasticsearch-analysis-ik-6.7.0.zip）。コマンドライン：必要なファイルをパッケージ化するために zip -r コマンドを実行します。 |
| セキュリティ上の問題 | プラグインのセキュリティポリシーに、機微な権限が含まれています。 | まず、セルフマネージド Elasticsearch クラスターでプラグインをテストしてください。「インストール前の確認事項」に記載されたテスト手順をご参照ください。 |
上記のいずれかのエラーを解決した後は、プラグインパッケージを plugins ディレクトリに配置し、以下のコマンドを実行してセルフマネージドクラスターで再テストを行ってください：
./bin/elasticsearch-plugins installこのローカル可用性テストに合格した後のみ、プラグインを Alibaba Cloud Elasticsearch へアップロードしてください。テストが失敗した場合は、エラーメッセージを確認し、上記の手順を繰り返してください。