はじめに
FESS (Flexible and Extensible Search System) は、オープンソースの検索エンジンです。この記事では、Windows環境でDocker Desktopを使用してFESSを導入する手順を説明します。
前提条件
- Windows 10または11がインストールされていること
- Docker Desktopがインストールされ、起動していること
手順
1. Docker Desktopのインストール
- Docker公式サイトからDocker Desktopをダウンロードします。
- ダウンロードしたインストーラーを実行し、画面の指示に従ってインストールを完了させます。
- インストールが完了したら、Docker Desktopを起動し、タスクバーのDockerアイコンが安定した状態（クジラのアイコン）になっていることを確認します。
2. Dockerのメモリ設定の変更
FESSを使用する際、デフォルトのメモリ設定では不足する場合があります。WSL 2を使用している場合は、.wslconfigファイルを作成し、適切なメモリ設定を行います。
- Disk image locationのフォルダ（通常は
C:\Users\<ユーザー名>）に移動し、.wslconfigファイルを作成します。cd ~ notepad .wslconfig - 以下の内容をファイルに記述し、保存します（例としてメモリを4GBに設定）。
[wsl2] memory=6GB # メモリの最大使用量 processors=2 # 使用するCPUコアの数 swap=2GB # スワップファイルのサイズ - Docker Desktopを再起動します。
3. FESSリポジトリのクローン
- 作業ディレクトリを作成します。
mkdir fess-docker cd fess-docker - Gitを使用してFESSのDockerリポジトリをクローンします。
git clone https://github.com/codelibs/docker-fess.git - クローンしたリポジトリのディレクトリに移動します。
cd docker-fess
4. Docker Composeの設定
-
docker-compose.ymlファイルを確認し、必要に応じて編集します。基本的にはデフォルトの設定で問題ありませんが、カスタマイズが必要な場合は適宜設定を変更してください。
5. FESSコンテナの起動
- README.mdに記載されているコマンドを使用してFESSコンテナを起動します。
docker compose --env-file .env.elasticsearch -f compose.yaml -f compose-elasticsearch8.yaml up -d
- 起動が完了したら、ブラウザで以下のURLにアクセスし、FESSの管理画面にログインします。
http://localhost:8080
6. FESSの初期設定
-
画面右上のログインから管理画面にアクセスします。
アカウント: admin
パスワード: admin
※パスワードは初回ログイン時に変更を求められます。
-
クロール設定
FESS管理画面で、ファイルのクロール設定を行います。詳細な設定手順は公式ドキュメントを参照してください。
メニューから「クローラー」を選択
「ウェブクロール設定」を開く
新規作成ボタンをクリック
必要な情報を入力
例として、Yahoo Japanをクロールする設定は以下の通りです。
名前: yahoo test
URL: https://www.yahoo.co.jp/
クロール対象とするURL: https://www.yahoo.co.jp/.*
クロール対象から除外するURL: (?i).*(css|js|jpeg|jpg|gif|png|bmp|wmv|xml|ico|exe)
設定後、「作成」ボタンをクリックします。
ファイルのクロール設定
ローカルファイルをElasticsearchの検索対象にするためには、まず被検索対象をクロールする必要があります。
左メニューの「クローラー」から「ファイルシステム」を選択
「新規作成」ボタンをクリック
検索対象にしたいファイルのある場所
例：「file:///var/log/」に設定
-
クロールの実行
設定が完了したら、クロールを実行してデータを収集します。管理画面から「ダッシュボード」に戻り、「クロールの開始」ボタンをクリックします。 -
検索の確認
クロールが完了したら、検索バーにキーワードを入力して、正常に検索結果が表示されることを確認します。
トラブルシューティング
- コンテナが正常に起動しない場合、以下のコマンドでログを確認します。
docker-compose logs - エラーが発生した場合は、設定ファイルやDockerの状態を確認し、必要に応じて修正します。
まとめ
以上で、Windows環境でDocker Desktopを使用してFESSを導入する手順は完了です。FESSを活用して、効率的な検索エンジンを構築しましょう。
この手順に従って、FESSの導入をスムーズに行うことができます。Dockerの基本的な操作や設定ファイルの編集に慣れていない場合は、公式ドキュメントや関連するリソースを参考にすると良いでしょう。