Alibaba Cloud Elasticsearch では、カスタムまたはオープンソースのプラグインをアップロードしてインストールできます。このトピックでは、手順について詳しく説明します。
説明
カスタム プラグインのインストール機能は、機能の内部アップグレードが実行されているため使用できません。この機能を使用する場合は、チケットを送信してご連絡ください。
前提条件
アップロードするプラグインが準備されています。プラグインが使用可能で安全であることを確認してください。
アップロードするプラグイン ファイルの名前は、長さが 8 ~ 128 文字で、文字、数字、ハイフン(-)、およびピリオド(.)のみを含めることができます。ファイル名の拡張子は .zip である必要があります。
重要
プラグインをアップロードする前に、Alibaba Cloud Elasticsearch クラスタと同じバージョンのセルフマネージド Elasticsearch クラスタでテストを実行することをお勧めします。テストが成功したら、プラグインをアップロードします。詳細については、「Installing Plugins」をご参照ください。
カスタム SQL プラグインをアップロードする場合は、Elasticsearch クラスタの YML 設定ファイルの xpack.sql.enabled パラメータが false に設定されていることを確認する必要があります。
詳細については、「YML ファイルの設定」をご参照ください。
制限
elasticsearch-analysis-hanlp など、操作権限を定義するセキュリティ ポリシーを持つプラグインはアップロードできません。
注意事項
カスタム プラグインのアップロードとインストール時に、コンソールで報告されたエラー、クラスタ更新の一時停止、検証の失敗などの問題が発生した場合は、「カスタム プラグインのインストール エラー」に記載されている手順に従って、問題の特定と解決を行うことができます。
Elasticsearch クラスタがアップグレードされると、クラスタにインストールされているプラグインは自動的に更新されません。プラグインを更新するには、新しいバージョンのプラグインを手動でアップロードする必要があります。
デフォルトでは、カスタム プラグインはインターネットにアクセスできません。クラスタが新しいネットワーク アーキテクチャにデプロイされている場合は、PrivateLink サービスを使用してクラスタのプライベート接続を確立し、クラスタにインストールされているカスタム プラグインがインターネットにアクセスできるようにすることができます。詳細については、「Elasticsearch クラスタのプライベート接続の設定」をご参照ください。クラスタが元のネットワーク アーキテクチャにデプロイされている場合、カスタム プラグインは、クラスタが存在する仮想プライベート クラウド(VPC)にのみアクセスできます。
カスタム プラグインは、Elasticsearch クラスタの安定性に影響を与える可能性があります。アップロードするカスタム プラグインが使用可能で安全であることを確認する必要があります。
手順
警告
カスタム プラグインのアップロードにより Elasticsearch クラスタが再起動され、プラグインがクラスタの安定性に影響を与える可能性があります。カスタム プラグインが使用可能で安全であることを確認してください。オフピーク時にカスタム プラグインをアップロードすることをお勧めします。
Alibaba Cloud Elasticsearch コンソール にログインします。
左側のナビゲーション ペインで、[elasticsearch クラスタ] をクリックします。
目的のクラスタに移動します。
上部のナビゲーション バーで、クラスタが属するリソース グループとクラスタが存在するリージョンを選択します。
[elasticsearch クラスタ] ページで、クラスタを見つけて ID をクリックします。
表示されるページの左側のナビゲーション ペインで、 を選択します。
[プラグイン] ページで、[カスタム プラグイン] タブをクリックします。次に、[アップロード] をクリックします。
カスタム プラグインをアップロードしてインストールします。
[プラグインのアップロード] パネルで、[ファイルを選択するか、ファイルをこの領域にドラッグ アンド ドロップします] をクリックします。次に、アップロードするカスタム プラグイン ファイルを選択し、[開く] をクリックします。
カスタム プラグイン ファイルをこの領域にドラッグしてアップロードすることもできます。次の図は、プラグイン ファイル elasticsearch-sql-6.7.0.0.zip が追加されたことを示しています。
アップロードするカスタム プラグイン ファイルは、以下の条件を満たす必要があります。ファイルが条件を満たさない場合、ファイルの検証に失敗する可能性があります。
注意事項を読み、チェックボックスをオンにして、[OK] をクリックします。
システムはクラスタを再起動します。オフピーク時にプラグインをアップロードすることをお勧めします。クラスタが再起動した後、[カスタム プラグイン] タブでプラグインを確認できます。[ステータス] が [インストール済み] の場合、プラグインは正常にアップロードおよびインストールされています。
プラグインが不要になった場合は、[カスタム プラグイン] タブで見つけて、[操作] 列の [削除] をクリックします。詳細については、「組み込みプラグインのインストールと削除」をご参照ください。