"An encouragement of Redmine Full text search plugin" Kohei Nakamura Movie : https://youtu.be/O4jLsPvARlw?t=7930 2019-11-02 redmine.tokyo #17 https://redmine.tokyo/projects/shinared/wiki/%E7%AC%AC17%E5%9B%9E%E5%8B%89%E5%BC%B7%E4%BC%9A

1. 2019/11/02 第17回 redmine.tokyo @ TOKYO
KOHEI NAKAMURA
全文検索
プラグインのすすめ

2. 自己紹介
オープン系エンジニア：10年
→メーカー(工場)の情シス: 6年
Redmine歴: 10年 管理者歴: 7年
全社 Redmineを 6年運用していて、
日々よりよい活用法を模索中
Kohei Nakamura
@neta
発表: 「ある工場の Redmine」ほか

3. 本日伝えたいこと
全文検索プラグイン
はいいぞ

4. “Full text search plugin”
Redmine の検索機能を
拡張するOSSプラグイン
株式会社クリアコード様と株式会社島津製作所様の共同開発
https://github.com/clear-code/redmine_full_text_search
全文検索
プラグインとは

5. 2019/08/31 第20回 Redmine 大阪
『Redmine全文検索システムの実際』
Kuniharu AKAHANE
きっかけ
赤羽根さんが
本番導入したらしい
ようし ウチもやろう！

6. 導入できました！

7. 結構むずかった・・・

8. 全文検索
プラグイン導入
【ToDo】
1. 動作環境確認
2. Mroonga インストール
3. Full text seach プラグイン インストール
4. Full text seach プラグイン インデックス作成

9. Mroonga とは
ストレージエンジンの例 : InnoDB, MyISAM
Mroonga は検索が得意なやつ
https://mariadb.com/kb/ja/choosing-the-right-storage-engine/
Mroongaについて
MroongaはMySQL用のストレージエンジンです。
すべてのMySQLユーザーに高速な日本語全文検索機能を提供します。
http://mroonga.org/ja

10. 完全に理解した

11. Full text search plugin 1.0.4
→ Redmine 4.0〜, Mroonga 9.0.3〜
ちょっと古い環境はダメ
(ex. Redmine 3.x, CentOS 6.x)
http://mroonga.org/ja/blog/2019/08/29/mroonga-9.07.html
動作環境

12. 動作環境OK
• Redmineバージョン 4.0.3 (SVN)
• OS : Linux CentOS 7.2
• Ruby 2.5.5 Rails 5.2.3
• Apache 2.4.6, MariaDB 10.1 + Mroonga 9.0.7
• 仮想サーバ：Mem 4G , CPU 2 Core , Disk 20 GB
• ユーザ数 : 300 チケット数 : 27,000
• 使用しているプラグイン : 14
• Full text search plugin 1.0.4

13. 2016/11/26 第11回 redmine.tokyo
『ある工場はこれで Redmine の
バージョンアップを決意した』
Redmine の
バージョンアップを
しちゃいましょう♪
以前 Redmine 2.5 の頃
MySQL が古くて
Full Text search 導入できなかった
動作環境NG

14. Mroonga
インストール
【Mroonga】インストール
http://mroonga.org/ja/docs/install.html
各環境ごとに説明あり
(Win,Mac,Linux…)
【Mroonga】インストールチ
ェック
http://mroonga.org/ja/docs/tutorial/installation_check.html

15. 問題発生
Mroonga バージョン確認が NG
9 のはずが 7 になってる
削除＆登録しなおしで解消
mysql > SHOW VARIABLES LIKE 'mroonga_version';
+-----------------+-------+
| mroonga_version | 7.07 |
+-----------------+-------+
/bin/mysql < /usr/share/mroonga/uninstall.sql
/bin/mysql < /usr/share/mroonga/install.sql
+-----------------+-------+
| mroonga_version | 9.07 |
+-----------------+-------+

16. プラグインを
インストール
手順に従い、
インストール→Redmine 再起動
https://github.com/clear-code/redmine_full_text_search
cd redmine/plugin
git clone https://github.com/clear-code/redmine_full_text_search.git plugins/full_text_search
bundle update
bundle exec rake redmine:plugins:migrate RAILS_ENV=production
(redmine restart)

17. 問題発生
やだー！
検索テスト
→検索結果 0件
これ
あかんやつ

18. 全文検索
プラグイン導入
【ToDo】
1. 動作環境確認
2. Mroonga インストール
3. Full text seach プラグイン インストール
4. Full text seach プラグイン インデックス作成

19. あっ

20. インデックス作成
まだやることがありました
バッチを実行して、インデックスを作ります
だからお前はアホなのだ
ぁあああーーッッ！！

21. 問題発生
バッチ実行
3時間経過
エラー出たぁ！
もう帰りたい
やだー！

22. たすけて！
困ったときは
「たすけて」
→ Twitter , Slack

23. なんとかなった
文字コードの問題っぽい
再実行して、
その後のが入ればいいのでは
なるほど 入ってるわ👍
！
外字のせいだ

24. ま いっか

25. よかったこと①
チケットが探しやすい！
ソートできる
● スコア/時系列表示
● 降順/昇順切り替え
絞り込みできる
● 担当者
● ステータス
● トラッカー
● 添付ファイル

26. よかったこと②
チケットが探しやすい！
● AND/OR
ex). redmine.tokyo OR Redmine大阪
● NOT検索
ex). 勉強会 - Redmine

27. よかったこと③
非常に高速
● 導入前: 〜3秒
● 導入後: 1秒未満

28. まとめ
全文検索プラグインは
いいぞ

29. 重要度 プラグイン名 説明
A Redmine Wiki Extensions plugin オートプレビュー、タブにWikiリンク貼り付け、PJごとにテーマ変更
A view customize plugin 画面をJavaScript/CSSで簡単にカスタマイズできる
A Redmine jsToolbar Extension wikiツールバー拡張
A Redmine jsToolbar Buttons Extension wikiツールバーボタン追加(赤・青文字、UNCリンク、折りたたみ、画面呼び出し)
A Redmine Wiki Unc plugin ファイルサーバへのリンクを貼れる
B Redmine Auto Done 100% チケット終了時に進捗率を自動で100％にする
B Redmine Default Custom Query チケット一覧にデフォルトのカスタムクエリを設定できる
B Redmine Banner Plugin お知らせ用バナー表示ができる
B Redmine Checklists plugin チケットにチェックリストを付与できる
B Sidebar Hide Plugin サイドバーを隠せる
B Redmine Issue Templates チケットのテンプレートを作成できる
B Full Text Search plugin Redmine 検索機能の拡張
C Redmine Wiki Lists plugin 特定の単語等で抽出したチケット一覧が作れる、自分が更新したチケット一覧表示
C Lychee Gantt Chart Pro ガントチャート機能拡張
利用プラグイン
(Redmine 4.0.3 + 14 プラグイン)

30. Thanks!
【Special】Full text search plugin
株式会社クリアコード 須藤 功平
株式会社島津ビジネスシステムズ 赤羽根 州晴
【WebSite】
Redmine : Jean-Philippe Langほか Redmine開発チーム
Redmine.JP : 前田 剛
Redmine.JP Blog : ファーエンドテクノロジー株式会社
プログラマの思索 : あきぴー
Enjoy*Study : onozaty (View Customize Pluginほか )
日々是精進。 : akiko_pusu
【Books】
『入門Redmine 第5版』前田 剛
【Others】
Redmine プラグイン 作者の方々
redmine.tokyo http://redmine.tokyo/
Discord Redmine Community https://discord.gg/tHgdVSj
"Icons are based on 'Material Design Icons' by Google. Licensed under CC BY."