Elasticsearchのローカル環境構築

最終更新日：2023年09月20日

技術

コピーしました

こんにちは。新卒二年目エンジニアの土屋です。

以前の私の記事ではElasticsearchのJava API Clientの使用方法をご紹介しましたが、今回はElasticsearch環境をローカルで立ち上げる方法をブログにしてみました！

概要

タイトルはElasticsearchのローカル環境構築としましたが、Elasticsearchのみでは環境構築後、色々と管理や操作が面倒なのでKibanaの立ち上げまで今回は説明していきます。

Kibanaとは

Elasticsearchのデータ可視化やElasticsearch等のElastic Stackの制御がGUI上で行えるものです。インデックス等の一覧の表示や管理が可能であり、実際にElasticsearchのAPIを叩くこともできます。

環境

今回は下記の環境でElasticsearchとKibanaの環境構築をしました。

使用PC

OS：Windows 10 Pro
実装メモリ(RAM)：16.0GB
システム：64 ビットオペレーティングシステム、x64 ベースプロセッサ

バージョン等

Elasticsearch : 8.10.1
Kibana : 8.10.1
Java 8

1. Javaのインストール

ElasticsearchはJavaで開発されているため、動かすにはJavaのインストールが必須となります。環境変数のJAVA_HOMEからJavaを呼ぶため、こちらの設定も必要になります。今回は詳細なJavaのインストール方法に関しては省略します。

2. Elasticsearchのダウンロードと起動

まずは、公式のダウンロードページからElasticsearchをダウンロードしてください。zipファイルがダウンロードされますので、解凍しておきましょう。

解凍したら以下の様なディレクトリ構成となっているはずです。

今回はデフォルトの設定で起動するため、後はbin\elasticsearch.batを実行するだけでElasticsearchが立ち上がります。非常に簡単ですね！

（起動前にconfig\elasticsearch.ymlを変更することでポート番号や各種設定を変更できます。）

3. Elasticsearchの起動確認

デフォルトのHTTPポートは9200となっているので、起動を確認するために以下のコマンドを叩いてみましょう。

curl localhost:9200?pretty

このままだと以下のようなレスポンスが返って来ると思います。


{
    "error" : {


      "root_cause" : [
        {
          "type" : "security_exception",
          "reason" : "missing authentication credentials for REST request [/?pretty]",          "header" : {
            "WWW-Authenticate" : [
              "Basic realm=\"security\" charset=\"UTF-8\"",
              "ApiKey"
            ]
          }
        }
      ],
      "type" : "security_exception",
      "reason" : "missing authentication credentials for REST request [/?pretty]",
      "header" : {
        "WWW-Authenticate" : [
          "Basic realm=\"security\" charset=\"UTF-8\"",
          "ApiKey"
        ]
      }
    },
    "status" : 401
}

認証情報がないと怒られてはいますが、Elasticsearch自体は起動していることが分かると思います。

4. Elasticsearchの接続確認

Elasticsearchの起動は確認できましたが、このままでは認証ができずElasticsearchを使用できないため、ビルドインユーザーを使って再度接続します。

ビルドインユーザーのパスワードはbin/elasticsearch-setup-passwords.batを実行することで設定できます。色々なビルドインユーザーのパスワードの設定をそれぞれで求められますが今回は全て同じ「pswd」に設定しました。ここではビルドインユーザー[elastic]を指定してcurlを実行します。

curl -u elastic:pswd localhost:9200?pretty

今度はエラーが無くclusterやバージョン等の情報が返ってくることが確認できました。


{
    "name" : "sample-name",
    "cluster_name" : "elasticsearch",
    "cluster_uuid" : "DL1Aa3_Wwxxx4AkqSP86ng",
    "version" : {
      "number" : "8.10.0",
      "build_flavor" : "default",
      "build_type" : "zip",
      "build_hash" : "e123da45c67890dfdc204971e600343b0aa78b0b",
      "build_date" : "2023-09-07T08:16:21.960703010Z",
      "build_snapshot" : false,
      "lucene_version" : "9.7.0",
      "minimum_wire_compatibility_version" : "7.17.0",
      "minimum_index_compatibility_version" : "7.0.0"
    },
    "tagline" : "You Know, for Search"
}

これでElasticseachが使えるようになりました。このままindexの操作や検索も可能ですし、ビルドインユーザを使って一般ユーザを作成することもできます。

5. Kibanaのダウンロードと起動

Elasticsearch同様、公式のダウンロードページからzipファイルをダウンロードして解凍します。

Kibanaが先ほど起動したElasticsearchに接続できるようにconfig\kibana.ymlのElasticsearchの設定欄のelasticsearch.usernameとelasticsearch.passwordに「kibana」と「paswd」を指定します。ここではビルドインユーザー[elastic]と権限が異なるビルドインユーザー[kibana]を使用します。

今回はビルドインユーザーを指定しましたが、サービスアカウントトークンを発行し、elasticsearch.serviceAccountTokenの設定でもElasticsearchに接続可能です。

では設定が完了したのでbin/kibana.batを実行してKibanaを起動します。(こちらもその他設定はデフォルトのまま)

デフォルトのHTTPポートは5601となっているのでブラウザでhttp://localhost:5601/を開いてみてください。

ログイン画面が出てくるので、とりあえずビルドインユーザー[elastic]を使ってログインします。

以下のような画面が表示されKibanaが問題なく使えるようになりました！

まとめ

今回はElasticsearchとKibanaのローカルでの環境構築方法をご紹介しました。実際にElasticsearchを運用するのはElastic Cloud等クラウド環境を使用するケースが多いかと思いますが、開発環境としてローカルPCでササっと環境構築して動くのは良いですね。

最後まで読んで頂きありがとうございました。

(土屋)

Gluegent Blog