カスタムプラグインのインストールエラー - Elasticsearch

このトピックでは、カスタムプラグインのインストール時に発生する可能性のある問題のトラブルシューティング方法について説明します。これらの問題には、コンソールで報告されるエラー、クラスタ更新の中断、検証の失敗などがあります。

問題の説明

カスタムプラグインをアップロードしてインストールする際に、コンソールで報告されるエラー、クラスタ更新の中断、検証の失敗などの問題が発生します。

一般的な解決策

カスタムプラグインをアップロードしてインストールする前に、セルフマネージドElasticsearchクラスタのインストールパスにある plugins フォルダにプラグインを配置する必要があります。次に、クラスタを再起動してプラグインを読み込みます。クラスタの再起動後、GET /_cat/plugins?v コマンドを実行して、プラグインがインストールされているかどうかを確認します。プラグインをインストールする際は、以下の点に注意してください。

Alibaba Cloud Elasticsearch によって提供される組み込みプラグインと同じ名前のプラグインはアップロードできません。
アップロードするプラグインの名前が組み込みプラグインと同じ名前の場合、アップロードする前にプラグインの名前を変更する必要があります。セルフマネージドElasticsearchクラスタで、pinyin分析やIK分析などのプラグインのインストールをテストする場合は、まずプラグインに対応するネイティブプラグインを削除する必要があります。次に、インストールするプラグインの名前を変更し、ネイティブプラグインに使用される以下のインストールコマンドを実行してプラグインをインストールします。プラグインがインストールされている場合は、Alibaba Cloud Elasticsearch クラスタにプラグインをアップロードしてインストールできます。
```
./bin/elasticsearch-plugin install file:///path-to-your-plugins.zip  // ネイティブプラグイン用のインストールコマンド
```
カスタムプラグインは、セルフマネージドElasticsearchクラスタでテストされた後にのみ、Alibaba Cloud Elasticsearch クラスタにアップロードしてインストールできます。これらのカスタムプラグインは、ネイティブプラグインに使用される以下のインストールコマンドを実行することで、クラスタにインストールされます。
```
./bin/elasticsearch-plugin install file:///path-to-your-plugins.zip // ネイティブプラグイン用のインストールコマンド
```
ローリングアップデートは、カスタムプラグインでは使用できません。
elasticsearch-analysis-hanlp プラグインなど、追加、削除、変更、クエリ権限を定義するセキュリティポリシーを持つプラグインはアップロードできません。
Logstash および Kibana 用のカスタムプラグインはインストールできません。Logstash または Kibana 用のカスタムプラグインをインストールする場合は、まずネイティブプラグインに使用されるインストールコマンドを実行して、セルフマネージドElasticsearchクラスタにプラグインをインストールする必要があります。プラグインがインストールされた後、チケットを提出して、Alibaba Cloud Elasticsearch のテクニカルサポートエンジニアに問い合わせてください。
説明要件を満たすプラグインがインストールされた後、Alibaba Cloud Elasticsearch コンソールの [クラスタログ] タブでプラグインのログをクエリできます。

コンソールで報告されるエラー

原因
アップロードしたプラグインが要件を満たしていません。
解決策
プラグインの情報を変更します。詳細については、一般的な解決策をご参照ください。たとえば、プラグインの名前を変更したり、プラグインの設定ファイルを変更したりできます。

クラスタ更新の中断

クラスタの更新が中断された場合は、以下の操作を実行して問題をトラブルシューティングできます。

プラグインのサイズを確認します。サイズが 50 MB 未満であることを確認してください。
プラグインのサイズが 50 MB 以上の場合、インストール中にプラグインの読み込み速度が遅くなります。この場合は、読み込みを終了し、プラグインを削除する必要があります。次に、プラグインの構成を変更します。たとえば、プラグインによって提供されるトークンをいくつか削除できます。プラグインを再度アップロードしてインストールする前に、プラグインのサイズが 50 MB 未満であることを確認してください。
システムがデータノードにデータを書き込んでいるかどうかを確認します。
- はい：数分間待機します。インストールがピーク時に行われているため、インストールプロセスが遅くなっています。
- いいえ：インストールを終了します。次に、プラグインを削除し、プラグインの可用性を再度テストします。

検証の失敗

次の表に、検証の失敗の原因とそれらの失敗に対する解決策を示します。

問題	原因	解決策
プラグインに指定された Elasticsearch のバージョンが、Alibaba Cloud Elasticsearch クラスタのバージョンと一致しません。	プラグインに指定された Elasticsearch のバージョンが、Alibaba Cloud Elasticsearch クラスタのバージョンと一致しません。	プラグインに指定された Elasticsearch のバージョンを変更し、プラグインを再度パッケージ化します。Jieba などの一部のプラグインでは、プラグインに指定された Elasticsearch のバージョンが Alibaba Cloud Elasticsearch クラスタのバージョンと一致していることを確認する必要があります。詳細については、FAQをご参照ください。
プラグインの plugin-descriptor.properties ファイルが見つかりません。	プラグインパッケージの解凍後、プラグインの plugin-descriptor.properties ファイルが見つかりません。	プラグインパッケージの解凍後に、余分なディレクトリレベルが生成されていないかどうかを確認します。たとえば、WinRAR を使用して [現在のフォルダに解凍] して、コンピュータ上のパッケージを解凍できます。この場合、解凍後に取得されるファイルは JAR ファイルであり、JAR ファイルのディレクトリレベルは正しいです。JAR ファイルが別のフォルダにある場合、JAR ファイルのディレクトリレベルは正しくありません。この場合は、JAR ファイルを再度パッケージ化する必要があります。JAR ファイルのパッケージ化に使用できる適切な方法の詳細については、次の問題の解決策を参照してください。
プラグインパッケージが無効です。	プラグインが関連する要件に基づいてパッケージ化されていません。その結果、取得したパッケージは無効です。	適切な方法を使用してプラグインを再度パッケージ化します。次のいずれかの方法を使用してプラグインをパッケージ化できます。 WinRAR：パッケージ化する JAR ファイルを右クリックし、[アーカイブに追加] を選択し、圧縮形式を ZIP に設定して、パッケージの名前を指定します。名前は elasticsearch で始まり、プラグインに指定された Elasticsearch のバージョン（例：elasticsearch-analysis-ik-6.7.0.zip）を含める必要があります。 Zip：`zip -r` コマンドを実行して、目的のファイルをパッケージ化します。
プラグインにセキュリティの問題があります。	プラグインのセキュリティポリシーに機密性の高い権限情報が含まれています。	Alibaba Cloud Elasticsearch クラスタにプラグインをインストールする前に、セルフマネージド Elasticsearch クラスタでプラグインのインストールをテストします。詳細については、一般的な解決策をご参照ください。

説明上記の表に記載されている問題が解決された後、プラグインパッケージを plugins フォルダに配置し、./bin/elasticsearch-plugins install コマンドを実行して、Alibaba Cloud Elasticsearch クラスタにプラグインをインストールする前に、セルフマネージド Elasticsearch クラスタでプラグインのインストールをテストする必要があります。プラグインのインストールに失敗した場合は、表示されるエラーメッセージに基づいてプラグインの可用性を再度テストする必要があります。プラグインが可用性テストに合格した後にのみ、Alibaba Cloud Elasticsearch クラスタにプラグインをアップロードしてインストールできます。