【Redmine】Phusion Passenger（Apache）環境にView Customize pluginをインストールする | ネコニウム研究所

Phusion Passenger（Apache）環境のRedmineにiew Customize pluginにインストールしたい！

概要

今回の記事では、Phusion Passenger（Apache）環境のRedmineにView Customize pluginにインストールする手順を掲載する。

仕様書

環境

Redmine version 5.0.5.stable
Ruby version 3.1.4-p223 (2023-03-30) [x86_64-linux]
Rails version 6.1.7.2
Phusion Passenger 6.0.18
View Customize plugin 3.4.0

手順書

プラグインのインストール自体はREADME.mdに記載されてるとおりで下記のコマンドを実行すればいいんだけども

cd {RAILS_ROOT}/plugins
git clone https://github.com/onozaty/redmine-view-customize.git view_customize
cd ../
bundle install --without development test
bundle exec rake redmine:plugins:migrate RAILS_ENV=production

ブラウザでRedmineにアクセスするとRedmineのエラーページが…。

Apacheのエラーログを見ると

[ N YYYY-MM-DD HH:MM:SS.SSS age/Cor/CoreMain.cpp:1325 ]: Passenger core shutdown finished
output: Error: The application encountered the following error: Could not find activerecord-compatible_legacy_migration-0.1.2 in locally installed gems (Bundler::GemNotFound)

activerecord-compatible_legacy_migrationというGemが足りないらしい。
このGemをインストールすればいいんだけども、一点注意なのが、このGemはRedmineが直接使うのではなくPassengerが使うので、Passengerをインストールしたユーザー、且つ、rbenvなどのバージョン管理を行ってる場合はPassengerをインストールしたバージョンでGemをインストールする必要がある。

gem install activerecord-compatible_legacy_migration -v '0.1.2'

Gemをインストール後にApache2を再起動。

sudo service apache2 restart

ブラウザでRedmineを正常に開ければOKだ！

まとめ（感想文）

実は、過去にも「View Customize plugin」をインストールしようとして失敗してたんだけども、やっとインストールできるようになった！

ログを確認するのが重要だと思った今日この頃。