HOWTO · MongoDB
Windows と Ubuntu で MongoDB とともに Elasticsearch をインストールして使用する方法
Windows 10 または Ubuntu 20.04 に Elasticsearch をインストールし、ローカルで確認して、検索のために MongoDB と組み合わせる方法を理解します。
このページの内容
Elasticsearch は MongoDB の隣で動作し、選択したアプリケーションデータに対する全文検索を提供できます。MongoDB が信頼できる情報源であり続けます。アプリケーションまたは別の統合プロセスが、変更を Elasticsearch インデックスにコピーしなければなりません。このガイドでは、Windows 10 または Ubuntu 20.04 で Elasticsearch を起動すること、そのローカルエンドポイントを確認すること、そして Node.js 統合に関わる判断について説明します。
Elasticsearch とは
Elasticsearch は Apache Lucene の上に構築された分散検索・分析エンジンです。JSON ドキュメントにインデックスを作成し、アプリケーションがテキストを検索したり構造化フィールドでフィルタリングしたりできるようにします。MongoDB はアプリケーションドキュメントを保存し、汎用クエリをサポートします。Elasticsearch は取得に最適化された別の検索インデックスを維持します。これは MongoDB の代替ではなく、2 つのストアが自動的に同期することはありません。
インデックスは派生データです。最初にどのように投入するか、その後の挿入、更新、削除をどのように伝播させるか、そして遅れが生じたりマッピングが変わったりした場合にどのように再構築するかを計画してください。
Windows 10 に Elasticsearch をインストールする
- そのリリースについて示された Windows のバージョンと Java ランタイム要件をサポートする Elasticsearch ディストリビューションを選択してください。公式アーカイブにはバンドルされた JDK が含まれている場合があります。Java を別途インストールする前に、そのリリースのインストールノートを確認してください。古い Java 7 や Java 8 の最小要件を一般的な要件として当てにしないでください。
- Elastic の公式 Elasticsearch ダウンロードページから Windows アーカイブをダウンロードし、アカウントが書き込めるディレクトリに展開してください。アーカイブの構成とセキュリティのデフォルトはリリースによって異なります。
- 展開した Elasticsearch の
binディレクトリでコマンドプロンプトまたは PowerShell を開き、elasticsearch.batを起動してください。フォアグラウンドプロセスが実行されている間、そのウィンドウを開いたままにしてください。永続的なサービスについては、フォアグラウンドウィンドウをサービスのインストールとして扱うのではなく、選択したリリースについて文書化されたサービスセットアップを使用してください。 - そのリリースのセキュリティ機能を有効なままにしてください。Elasticsearch 8 以降ではセキュリティがデフォルトで有効になります。生成された認証情報を使用するか、適切なユーザーと TLS 設定を構成してください。ネットワークからアクセス可能なインスタンスで
xpack.security.enabled: falseを設定しないでください。セキュリティを無効にすることは、信頼できないネットワークアクセスのない孤立したローカル実験にのみ適しています。 - ブラウザで
http://localhost:9200を確認するか、curlでリクエストしてください。正常なセキュリティ保護されたノードは認証情報を求めたり認証応答を返したりする場合がありますが、それでもエンドポイントに到達できることが示されます。セットアップ中に表示または構成された認証情報と HTTPS の詳細を使用してください。
エンドポイントが応答しない場合は、起動ウィンドウでブートストラップエラーや構成エラーを確認し、プロセスがまだ実行されていることを確かめ、別のプロセスがポート 9200 を使用していないことを確認してください。
Ubuntu 20.04 に Elasticsearch をインストールする
- サポートとパッケージ要件に Ubuntu 20.04 が含まれるリリースを選択してください。Elastic の公式 APT インストールガイドを開き、選択したリリースのリポジトリと署名キーの手順に従ってください。これらの手順により、APT が Elastic のパッケージ署名キーを信頼し、Elastic のリポジトリからパッケージを取得するように構成されます。
apt-keyに基づく古い手順は非推奨です。ガイドに示されたキーリング方式を使用してください。Elasticsearch パッケージには通常、適切なバンドル JDK が含まれているため、選択したリリースの手順で必要な場合にのみ、別途 Java パッケージをインストールしてください。 - 選択したリリースのリポジトリを構成した後、
sudo apt-get updateで APT のパッケージインデックスを更新し、次にsudo apt-get install elasticsearchで Elasticsearch をインストールしてください。再現可能なデプロイが必要な場合は、apt-cache madison elasticsearchでそのリポジトリから利用可能なバージョンを確認し、sudo apt-get install elasticsearch=<package-version>を使用して正確なパッケージバージョンをインストールしてください。APT が報告するバージョン文字列を使用してください。リポジトリ行と利用可能なバージョンは、Elastic のガイドで選択したリリースに依存します。 sudo systemctl enable --now elasticsearch.serviceでサービスを起動して有効にしてください。sudo systemctl status elasticsearch.serviceで確認してください。起動に失敗した場合は、サービスのジャーナルまたは/var/log/elasticsearch/を調べてください。- 主な構成は通常
/etc/elasticsearch/elasticsearch.ymlです。認証とトランスポートセキュリティを有効なままにし、ネットワークへの公開を慎重に構成してください。単一ノードのセットアップが自動的に公開しても安全であるとは限りません。 - ご使用のリリースの認証情報と証明書セットアップを使用して
https://localhost:9200を確認してください。証明書の警告は、ローカル CA がクライアントに信頼されていないことを意味する場合があります。検証を無効にするのではなく、証明書を確認するか、生成された CA を信頼するようにクライアントを構成してください。
ローカル応答が成功すれば、Elasticsearch が実行されていることが確認できます。MongoDB のレコードがインデックス作成されていることは確認できません。
MongoDB とともに Elasticsearch を使用する理由
MongoDB は一般にアプリケーションレコードの権威あるストアであり、Elasticsearch は別途維持されるインデックスに対する検索を提供します。この組み合わせにより、検索インデックスをデータの唯一のコピーにすることなく全文検索を提供できます。検索結果は MongoDB より遅れる場合があるため、即時の整合性が必要なアプリケーションはその遅延を考慮する必要があります。
Node.js 統合には、MongoDB の変更ソース、選択したサーバーバージョンと互換性のある Elasticsearch クライアント、そして明示的なインデックス作成戦略が必要です。一般的なフローでは、初期インデックスのために既存のレコードを読み取り、その MongoDB の _id から派生した安定したドキュメント ID を使用して各レコードを Elasticsearch に書き込み、その後、挿入、更新、削除が発生するたびに適用します。書き込みを再試行可能で冪等にし、失敗を再生用に記録し、インデックスを照合または再構築する方法を提供してください。MongoDB のサンプルドキュメントを確認し、対応する Elasticsearch ドキュメントをクエリして、両側を検証してください。
次の Node.js の例は、MongoDB レコードから Elasticsearch のドキュメント ID と JSON ボディへの決定的なマッピングを示しています。これはどちらのサービスもなしに実行されます。データベースへの書き込みや同期ではなく、ペイロードの形のみを示しています。
const mongoRecord = {
_id: "product-42",
name: "Trail shoes",
category: "footwear"
};
const elasticsearchDocument = {
id: String(mongoRecord._id),
document: {
name: mongoRecord.name,
category: mongoRecord.category
}
};
console.log(JSON.stringify(elasticsearchDocument, null, 2));
{
"id": "product-42",
"document": {
"name": "Trail shoes",
"category": "footwear"
}
}
この形をアプリケーションで使用するには、保守されている Elasticsearch クライアントを通じて、id を Elasticsearch のドキュメント ID として、document をそのソースとして送信してください。その書き込みをアプリケーションの MongoDB 変更処理に接続し、再試行と削除を明示的に処理してください。この例は、特定のクライアント、プラグイン、または Elasticsearch リリースが互換であることを示すものではありません。
元の mongoosastic の例は、レガシーな Mongoose プラグインと互換性のある Elasticsearch クライアントに依存しています。現在の Elasticsearch リリースとの互換性はここでは示されていません。そのため、そのスニペットやその成功メッセージを検証済みの統合として扱わないでください。採用する前に、そのプラグインがプロジェクト内の正確な Mongoose と Elasticsearch のバージョンをサポートしていることを確認してください。新しい統合については、保守されているクライアントを使用し、インデックス作成と変更ストリームに関するそのバージョン固有のガイダンスに従ってください。基本的な保存コールバックだけでは、インデックス作成が完了したことは証明されません。