Elasticsearch:Cerebro を使用したクラスターへの接続

ステップ 1：追加する IP アドレスの確認

ステップ 2：IP アドレスをホワイトリストに追加

1. Elasticsearch コンソールにログインし、クラスターの [基本情報] ページに移動します。ナビゲーションペインで、[設定と管理] > [セキュリティ設定] を選択します。

2. [変更] をクリックして、ホワイトリストダイアログボックスを開きます。

   

3. デフォルトグループの右側にある [設定] をクリックし、IP アドレスを追加します。

   • 複数の IP アドレスまたは CIDR ブロックは、カンマで区切ります。前後にスペースは入れません。

   • 1 つのクラスターは、最大 300 の IP アドレスまたは CIDR ブロックをサポートします。

   • 別のグループを作成するには、[IP ホワイトリストグループの追加] をクリックします。グループは IP アドレスの管理専用です。すべてのグループの IP は同じアクセス権限を共有します。

   重要

   ホワイトリストを 0.0.0.0/0 または ::/0 に設定しないでください。これらの設定は任意の IP アドレスからのアクセスを許可し、重大なセキュリティリスクをもたらします。一部のクラスターバージョン (7.16 や 8.5 など) やリージョンでは、これらの値はサポートされていません。IPv6 ホワイトリストのサポートは、中国 (杭州) リージョンの v2 デプロイメントアーキテクチャを使用するクラスターに限定されます。

   サポートされている形式：

   タイプ	形式	例
   IPv4 単一アドレス	A.B.C.D	192.168.0.1
   IPv4 CIDR ブロック	A.B.C.D/N	192.168.0.0/24
   IPv4 すべて拒否	—	127.0.0.1
   IPv4 すべて許可 (高リスク)	—	0.0.0.0/0
   IPv6 単一アドレス	—	2401:XXXX:1000:24::5
   IPv6 CIDR ブロック	—	2401:XXXX:1000::/48
   IPv6 すべて拒否	—	::1
   IPv6 すべて許可 (高リスク)	—	::/0

   

4. [確認] をクリックします。

   

1. Cerebro のインストールと設定

ECS インスタンスに接続します。以下の手順では Linux システムを使用します。接続手順については、「ECS インスタンスへの接続」をご参照ください。

1. ECS インスタンスに JDK 1.8 以降をインストールします。「OpenJDK の手動デプロイ」をご参照ください。

2. Cerebro パッケージをダウンロードして展開します。

   この例では v0.9.0 を使用します。最新バージョンを使用するには、Cerebro のリリース を確認し、ダウンロード URL を適宜更新してください。

   # Cerebro v0.9.0 のダウンロード
   wget https://github.com/lmenezes/cerebro/releases/download/v0.9.0/cerebro-0.9.0.tgz
   
   # パッケージの展開
   tar -zxvf cerebro-0.9.0.tgz

3. Cerebro の設定ファイルを開きます。

   vim cerebro-0.9.0/conf/application.conf

4. hosts パラメーターを設定して Cerebro が Elasticsearch クラスターを指すようにし、ファイルを保存します。

   Cerebro を複数のクラスターに接続するには、hosts 配列に複数のエントリをカンマで区切って追加します。

   パラメーター	説明
   host	クラスターエンドポイント。プライベートアクセスには http://<VPC プライベートエンドポイント>:9200 を、パブリックアクセスには http://<パブリックエンドポイント>:9200 を使用します。ES クラスターではデフォルトで HTTP が有効になっています。トラフィックを暗号化するには、[設定と管理] > [セキュリティ設定] で HTTPS を有効にします。HTTPS を有効にする前に、アプリケーションコードを更新して HTTPS 接続をサポートするようにしてください。既存の HTTP ベースのコードは動作しなくなります。
   name	Elasticsearch クラスター ID。Elasticsearch コンソールのクラスターリストで確認できます。
   username	クラスターのユーザー名。デフォルトは elastic で、完全なクラスター権限を持っています。本番環境では、代わりに Elasticsearch X-Pack のロール管理 を使用して、権限範囲を限定した専用ユーザーを作成してください。
   password	指定したユーザーのパスワード。

   # 既知のホストのリスト
   hosts = [
     #{
     #  host = "http://localhost:9200"
     #  name = "Localhost cluster"
     #  headers-whitelist = [ "x-proxy-user", "x-proxy-roles", "X-Forwarded-For" ]
     #}
     # 認証付きホストの例
     {
       host = "http://es-cn-xxx.elasticsearch.aliyuncs.com:9200"
       name = "es-cn-xxx"
       auth = {
         username = "elastic"
         password = "xxx"
       }
     }
   ]

2. Cerebro サービスの起動

フォアグラウンドでの起動 (デバッグ用)：

cd cerebro-0.9.0
bin/cerebro

Cerebro が正常に起動すると、ターミナルに確認メッセージが表示されます。

[root@VM01 cerebro-0.9.0]# bin/cerebro
[info] play.api.Play - Application started (Prod) (no global state)
[info] p.c.s.AkkaHttpServer - Listening for HTTP on /0.0.0.0:9000

バックグラウンドでの起動 (本番環境用)：

cd cerebro-0.9.0
nohup bin/cerebro > cerebro.log 2>&1 &

ログを表示するには： tail -f cerebro.log

サービスを停止するには： pkill -f cerebro

3. ブラウザーで Cerebro を開き、クラスターに接続

1. ECS セキュリティグループで、Cerebro にアクセスするデバイスの IP アドレスに対し、ポート 9000 へのインバウンドトラフィックを許可します。手順については、「セキュリティグループルールの追加」をご参照ください。

2. ブラウザーで http://<ECS インスタンスのパブリック IP アドレス>:9000 にアクセスします。

3. Cerebro のログインページに、application.conf で設定したクラスターが表示されます。接続するクラスターをクリックします。

4. 接続後、Cerebro コンソールにクラスターヘルス、インデックス、その他の管理オプションが表示されます。

   接続後、Cerebro コンソールにクラスターのステータスが green で表示されます。クラスターの概要には、ノード数 (2 ノード)、インデックス数 (22 インデックス)、シャード数 (44 シャード)、ドキュメント数、ストレージサイズが含まれます。概要の下には、各インデックスのシャード分布や、各ノードのヒープ、ディスク、CPU、ロードのメトリクスを表示できます。

Cerebro の使用に関する詳細については、「Cerebro ドキュメント」をご参照ください。

Cerebro が起動しない

以下を確認してください：

• JDK がインストールされていない、またはバージョンが 1.8 未満。java -version を実行して確認します。バージョンが 1.8 未満の場合は、互換性のある JDK をインストールしてください。

• ポート 9000 が既に使用されている。application.conf で http.port を別の値に設定してポートを変更します。

• 起動スクリプトに実行権限がない。chmod +x bin/cerebro を実行して権限を追加してください。

Elasticsearch クラスターへの接続に失敗した

以下を確認してください：

• IP アドレスホワイトリストが設定されていない。Cerebro ホストの IP アドレスが Elasticsearch コンソールの正しいホワイトリスト (VPC プライベートまたはパブリック) に追加されていることを確認してください。

• 設定のエンドポイントまたはポートが正しくない。application.conf の host の値がクラスターエンドポイントと一致し、ポート 9200 を使用していることを確認してください。

• ECS セキュリティグループがトラフィックをブロックしている。セキュリティグループがポート 9200 (Elasticsearch) とポート 9000 (Cerebro) でのインバウンドトラフィックを許可していることを確認してください。

• ユーザー名またはパスワードが正しくない。application.conf の認証情報が正しいことを確認してください。