Ubuntu16.04にElasticsearchをインストールして設定する方法
序章
Elasticsearch は、データをリアルタイムで分散検索および分析するためのプラットフォームです。 その人気は、その使いやすさ、強力な機能、およびスケーラビリティによるものです。
ElasticsearchはRESTful操作をサポートしています。 これは、HTTPメソッド(GET、POST、PUT、DELETEなど)をHTTP URI(/collection/entry
)データを操作します。 直感的なRESTfulアプローチは、開発者とユーザーの両方に優しいものであり、これがElasticsearchの人気の理由の1つです。
Elasticsearchは無料のオープンソースソフトウェアであり、その背後には確固たる会社であるElasticがあります。 この組み合わせにより、個人テストから企業統合まで、あらゆる場所での使用に適しています。
この記事では、Elasticsearchを紹介し、Elasticsearchをインストール、構成、保護、および使用を開始する方法を示します。
前提条件
このチュートリアルを実行する前に、次のものが必要です。
-
Ubuntu 16.04を使用した初期サーバーセットアップ(sudo非rootユーザーの作成を含む)に従ってセットアップされたUbuntu16.04ドロップレット。
-
Oracle JDK 8がインストールされました。これは、このJavaインストール記事の「OracleJDKのインストール」セクションに従って実行できます。
特に明記されていない限り、このチュートリアルでroot権限を必要とするすべてのコマンドは、sudo権限を持つroot以外のユーザーとして実行する必要があります。
ステップ1—Elasticsearchのダウンロードとインストール
Elasticsearchはelastic.coから直接ダウンロードできます。 zip
, tar.gz
, deb
、 また rpm
パッケージ。 Ubuntuの場合は、 deb
(Debian)Elasticsearchを実行するために必要なすべてをインストールするパッケージ。
まず、パッケージインデックスを更新します。
- sudo apt-get update
最新のElasticsearchバージョンをダウンロードします。これは執筆時点では2.3.1です。
- wget https://download.elastic.co/elasticsearch/release/org/elasticsearch/distribution/deb/elasticsearch/2.3.1/elasticsearch-2.3.1.deb
次に、通常のUbuntuの方法でインストールします。 dpkg
.
- sudo dpkg -i elasticsearch-2.3.1.deb
これにより、Elasticsearchがにインストールされます /usr/share/elasticsearch/
構成ファイルが配置されている /etc/elasticsearch
とその初期化スクリプトが追加されました /etc/init.d/elasticsearch
.
Elasticsearchがサーバーで自動的に開始および停止するようにするには、そのinitスクリプトをデフォルトのランレベルに追加します。
- sudo systemctl enable elasticsearch.service
Elasticsearchを初めて起動する前に、推奨される最小構成について次のセクションを確認してください。
ステップ2—Elasticsearchを設定する
ElasticsearchとそのJava依存関係がインストールされたので、Elasticsearchを構成します。 Elasticsearch構成ファイルは /etc/elasticsearch
ディレクトリ。 2つのファイルがあります:
-
elasticsearch.yml
Elasticsearchサーバーの設定を構成します。 これは、ロギングのオプションを除くすべてのオプションが保存される場所です。そのため、このファイルに主に関心があります。 -
logging.yml
ロギングの構成を提供します。 最初は、このファイルを編集する必要はありません。 すべてのデフォルトのロギングオプションをそのままにしておくことができます。 結果のログは次の場所にあります/var/log/elasticsearch
デフォルトでは。
Elasticsearchサーバーでカスタマイズする最初の変数は次のとおりです。 node.name
と cluster.name
の elasticsearch.yml
. 彼らの名前が示すように、 node.name
サーバー(ノード)の名前と、後者が関連付けられているクラスターを指定します。
これらの変数をカスタマイズしない場合、 node.name
ドロップレットのホスト名に関して自動的に割り当てられます。 The cluster.name
デフォルトのクラスターの名前に自動的に設定されます。
The cluster.name
valueは、Elasticsearchの自動検出機能によって使用され、Elasticsearchノードを自動的に検出してクラスターに関連付けます。 したがって、デフォルト値を変更しないと、クラスター内の同じネットワーク上に不要なノードが見つかる可能性があります。
メインの編集を開始するには elasticsearch.yml
構成ファイル nano
またはお気に入りのテキストエディタ。
- sudo nano /etc/elasticsearch/elasticsearch.yml
を削除します #
行頭の文字 cluster.name
と node.name
コメントを外してから、値を更新します。 での最初の構成変更 /etc/elasticsearch/elasticsearch.yml
ファイルは次のようになります。
. . .
cluster.name: mycluster1
node.name: "My First Node"
. . .
これらは、Elasticsearchを使用して開始できる最小設定です。 ただし、Elasticsearchをより完全に理解して微調整するために、構成部分を読み続けることをお勧めします。
Elasticsearchの特に重要な設定の1つは、マスターまたはスレーブのいずれかであるサーバーの役割です。 マスターサーバーは、クラスターの正常性と安定性を担当します。 多数のクラスターノードを使用する大規模な展開では、複数の専用マスターを使用することをお勧めします。 通常、専用マスターはデータを保存したり、インデックスを作成したりしません。 したがって、クラスターの状態が危険にさらされる可能性がある過負荷になる可能性はありません。
スレーブサーバーは、データタスクをロードできる主力製品として使用されます。 スレーブノードが過負荷になった場合でも、追加の負荷をかける他のノードがあれば、クラスターの状態に深刻な影響を与えることはありません。
サーバーの役割を決定する設定が呼び出されます node.master
. デフォルトでは、ノードはマスターです。 Elasticsearchノードが1つしかない場合は、このオプションをデフォルトのままにしておく必要があります true
少なくとも1つのマスターが常に必要であるため、値。 または、ノードをスレーブとして構成する場合は、 false
変数の値 node.master
このような:
. . .
node.master: false
. . .
もう1つの重要な構成オプションは node.data
、ノードがデータを保存するかどうかを決定します。 ほとんどの場合、このオプションはデフォルト値のままにしておく必要があります(true
)が、ノードにデータを保存したくない場合が2つあります。 1つは、前述のように、ノードが専用マスターである場合です。 もう1つは、ノードがノードからデータをフェッチして結果を集約するためだけに使用される場合です。 後者の場合、ノードは検索ロードバランサーとして機能します。
繰り返しますが、Elasticsearchノードが1つしかない場合は、この値を変更しないでください。 それ以外の場合、データのローカル保存を無効にするには、 node.data
なので false
このような:
. . .
node.data: false
. . .
多くのノードを含む大規模なElasticsearchデプロイメントでは、他に2つの重要なオプションがあります。 index.number_of_shards
と index.number_of_replicas
. 1つ目は、インデックスが分割されるピース、つまりシャードの数を決定します。 2つ目は、クラスター全体に分散されるレプリカの数を定義します。 シャードを増やすとインデックス作成のパフォーマンスが向上し、レプリカを増やすと検索が高速になります。
デフォルトでは、シャードの数は5で、レプリカの数は1です。 単一ノードでElasticsearchを引き続き調査およびテストしていると仮定すると、シャードは1つだけで、レプリカは使用できません。 したがって、それらの値は次のように設定する必要があります。
. . .
index.number_of_shards: 1
index.number_of_replicas: 0
. . .
あなたが変更することに興味があるかもしれない1つの最終的な設定は path.data
、データが保存されるパスを決定します。 デフォルトのパスは /var/lib/elasticsearch
. 本番環境では、Elasticsearchデータを保存するために専用のパーティションとマウントポイントを使用することをお勧めします。 最良の場合、この専用パーティションは、より優れたパフォーマンスとデータ分離を提供する別個のストレージメディアになります。 別のを指定できます path.data
次のように指定してパスを指定します。
. . .
path.data: /media/different_media
. . .
すべての変更を行ったら、ファイルを保存して終了します。 これで、Elasticsearchを初めて起動できます。
- sudo systemctl start elasticsearch
Elasticsearchを使用する前に、Elasticsearchをいくつか使用して完全に開始してください。 そうしないと、接続できないというエラーが発生する可能性があります。
ステップ3—Elasticsearchの保護
デフォルトでは、Elasticsearchにはセキュリティが組み込まれておらず、HTTPAPIにアクセスできるすべてのユーザーが制御できます。 Elasticsearchはループバックインターフェイスでのみリッスンするため、これは必ずしもセキュリティリスクではありません(つまり、 127.0.0.1
)ローカルでのみアクセスできます。 したがって、パブリックアクセスは不可能であり、すべてのサーバーユーザーが信頼されているか、これが専用のElasticsearchサーバーである限り、Elasticsearchは十分に安全です。
それでも、セキュリティを強化したい場合、最初に行うことは認証を有効にすることです。 認証は、商用のシールドプラグインによって提供されます。 残念ながら、このプラグインは無料ではありませんが、テストに使用できる30日間の無料トライアルがあります。 その公式ページには、優れたインストールと構成の手順があります。 さらに知っておく必要があるのは、Elasticsearchプラグインのインストールマネージャーへのパスが /usr/share/elasticsearch/bin/plugin
.
商用プラグインを使用したくないが、HTTP APIへのリモートアクセスを許可する必要がある場合は、少なくともUbuntuのデフォルトファイアウォールであるUFW(Uncomplicated Firewall)を使用してネットワークの露出を制限できます。 デフォルトでは、UFWはインストールされていますが、有効になっていません。 使用する場合は、次の手順に従ってください。
まず、必要なサービスを許可するルールを作成します。 サーバーにログインできるようにするには、少なくともSSHが許可されている必要があります。 SSHへのワールドワイドアクセスを許可するには、ポート22をホワイトリストに登録します。
- sudo ufw allow 22
次に、信頼できるリモートホストのデフォルトのElasticsearch HTTP APIポート(TCP 9200)へのアクセスを許可します。TRUSTED_IP
、 このような:
- sudo ufw allow from TRUSTED_IP to any port 9200
その後、次のコマンドでUFWを有効にします。
- sudo ufw enable
最後に、次のコマンドを使用してUFWのステータスを確認します。
- sudo ufw status
ルールを正しく指定した場合、出力は次のようになります。
Output of java -versionStatus: active
To Action From
-- ------ ----
9200 ALLOW TRUSTED_IP
22 ALLOW Anywhere
22 (v6) ALLOW Anywhere (v6)
UFWが有効になっていて、Elasticsearchポート9200を保護していることを確認したら、Elasticsearchに外部接続のリッスンを許可できます。 これを行うには、 elasticsearch.yml
構成ファイルを再度。
- sudo nano /etc/elasticsearch/elasticsearch.yml
を含む行を検索します network.bind_host
、削除してコメントを外します #
行頭の文字を入力し、値を次のように変更します 0.0.0.0
したがって、次のようになります。
. . .
network.host: 0.0.0.0
. . .
指定しました 0.0.0.0
ElasticsearchがすべてのインターフェースとバインドされたIPをリッスンするようにします。 特定のインターフェースでのみリッスンする場合は、代わりにIPを指定できます。 0.0.0.0
.
上記の設定を有効にするには、次のコマンドでElasticsearchを再起動します。
- sudo systemctl restart elasticsearch
その後、信頼できるホストからElasticsearchに接続してみてください。 接続できない場合は、UFWが機能していることと network.host
変数が正しく指定されています。
ステップ4—Elasticsearchのテスト
これで、Elasticsearchはポート9200で実行されているはずです。 あなたはそれをテストすることができます curl
、コマンドラインクライアント側URL転送ツールと単純なGETリクエスト。
- curl -X GET 'http://localhost:9200'
次の応答が表示されます。
Output of curl{
"name" : "My First Node",
"cluster_name" : "mycluster1",
"version" : {
"number" : "2.3.1",
"build_hash" : "bd980929010aef404e7cb0843e61d0665269fc39",
"build_timestamp" : "2016-04-04T12:25:05Z",
"build_snapshot" : false,
"lucene_version" : "5.5.0"
},
"tagline" : "You Know, for Search"
}
上記のような応答が表示された場合、Elasticsearchは正常に機能しています。 そうでない場合は、インストール手順を正しく実行し、Elasticsearchが完全に起動するまでしばらく待っていることを確認してください。
Elasticsearchのより徹底的なチェックを実行するには、次のコマンドを実行します。
- curl -XGET 'http://localhost:9200/_nodes?pretty'
上記のコマンドの出力では、ノード、クラスター、アプリケーションパス、モジュールなどの現在のすべての設定を確認して確認できます。
ステップ5—Elasticsearchを使用する
Elasticsearchの使用を開始するには、最初にいくつかのデータを追加しましょう。 すでに述べたように、ElasticsearchはRESTful APIを使用します。これは、通常のCRUDコマンド( c reate、 r ead、 u pdate、および d)に応答します。 elete。 それを扱うために、私たちは再び使用します curl
.
次のコマンドを使用して、最初のエントリを追加できます。
- curl -X POST 'http://localhost:9200/tutorial/helloworld/1' -d '{ "message": "Hello World!" }'
次の応答が表示されます。
Output{"_index":"tutorial","_type":"helloworld","_id":"1","_version":1,"_shards":{"total":2,"successful":1,"failed":0},"created":true}
と curl
、ElasticsearchサーバーにHTTPPOSTリクエストを送信しました。 リクエストのURIは /tutorial/helloworld/1
いくつかのパラメータで:
tutorial
Elasticsearchのデータのインデックスです。helloworld
タイプです。1
上記のインデックスとタイプの下にあるエントリのIDです。
この最初のエントリは、HTTPGETリクエストで取得できます。
- curl -X GET 'http://localhost:9200/tutorial/helloworld/1'
結果は次のようになります。
Output{"_index":"tutorial","_type":"helloworld","_id":"1","_version":1,"found":true,"_source":{ "message": "Hello World!" }}
既存のエントリを変更するには、HTTPPUTリクエストを使用できます。
- curl -X PUT 'localhost:9200/tutorial/helloworld/1?pretty' -d '
- {
- "message": "Hello People!"
- }'
Elasticsearchは、次のような変更が成功したことを確認する必要があります。
Output{
"_index" : "tutorial",
"_type" : "helloworld",
"_id" : "1",
"_version" : 2,
"_shards" : {
"total" : 2,
"successful" : 1,
"failed" : 0
},
"created" : false
}
上記の例では、 message
「HelloPeople!」への最初のエントリーの これにより、バージョン番号は自動的にに増加しました 2
.
あなたは余分な議論に気づいたかもしれません pretty
上記のリクエストで。 これにより、人間が読める形式が可能になり、各データフィールドを新しい行に書き込むことができます。 また、データを取得するときに結果を「きれいに」して、次のようにはるかに優れた出力を取得することもできます。
- curl -X GET 'http://localhost:9200/tutorial/helloworld/1?pretty'
これで、応答ははるかに優れた形式になります。
Output{
"_index" : "tutorial",
"_type" : "helloworld",
"_id" : "1",
"_version" : 2,
"found" : true,
"_source" : {
"message" : "Hello People!"
}
}
これまで、Elasticsearchにデータを追加してクエリを実行してきました。 その他の操作については、APIドキュメントを確認してください。
結論
これは、Elasticsearchのインストール、構成、および使用開始が非常に簡単なことです。 手動クエリを十分に試したら、次のタスクはアプリケーションからそれを使い始めることです。