はじめに
みなさんは何でタスク管理をしていますか？
私は下記の条件をもとにRedmineを選びました。
- 無料で使える
- 自分好みにカスタマイズができる
- プラグインが充実している
そこでまずは、自分のローカル環境にRedmineを構築し、
使い続けて良さそうであれば外部サーバ上に構築しようと考えました。
今回の記事ではローカル環境での使用を想定しているため、
httpsで接続できるようにするところまでは記載していません。
どこかのタイミングでhttpsで接続する場合の構築手順も書くと思います。。
対象読者
- Linuxを直で触りたい人
- Redmineを触りたい人
Redmineとは
Redmineについては、この記事が参考になりました！
入門 — Redmine Slides
環境
| 項目 | バージョン |
|---|---|
| Redmine | Redmine4.2 |
| OS | CentOS 7.8 |
| データベース | MySQL 8.0.25 |
| webサーバ | Apache/2.4.6 |
| Ruby | ruby 2.4.6 |
手順
できるだけパッケージ管理ツール(yum等)を使ってソフトを管理したいため、
ソースコードをダウンロードしてビルドする手順は避けています。
そのため最新バージョンを使っていないソフトもあります。
1. SELinux 無効化
下記の設定ファイルを開き、SELINUX=disabledに変更します。
$ sudo vi /etc/sysconfig/selinux
※セキュリティ的にはSELinuxの無効化は避けたいですが、ローカル環境のため一旦は簡単なやり方で構築します。調べたところSELinuxを有効化した状態でも構築できるので時間のある人はぜひ構築してみてください！
2. Ruby, Passengerのビルドに必要なパッケージのインストール
$ sudo yum install openssl-devel readline-devel zlib-devel curl-devel libyaml-devel libffi-devel
3. MySQLのインストール
$ sudo yum install mysql mysql-devel
※ MySQL の構築手順は省きます。
4. Apacheとヘッダファイルのインストール
$ sudo yum install httpd httpd-devel
5. ImageMagickとヘッダファイル・日本語フォントのインストール
$ sudo yum install ImageMagick ImageMagick-devel ipa-pgothic-fonts
6. Rubyのインストール
$ sudo yum install centos-release-scl-rh centos-release-scl
$ sudo yum --enablerepo=centos-sclo-rh install rh-ruby24 rh-ruby24-ruby-devel
7. インストールしたRubyの環境変数の設定
以下の設定はコンソールからの実行時に既存のRubyではなく、今回インストールしたRubyを使用するようにしています。
# cat << 'EOF' | sudo tee /etc/profile.d/rh-ruby.sh
#!/bin/bash
source scl_source enable rh-ruby24
EOF
8. 共有ライブラリにパス設定
以下のファイルにライブラリパスを設定します。
$ sudo vi /etc/ld.so.conf
====
/opt/rh/rh-ruby24/root/usr/lib64
9. bundlerのインストール
$ sudo gem install bundler
※IPv6を利用してのインストールは失敗するため、使用するネットワークを確認してください。
参考サイト：
【Rails】gem updateやgem installコマンドでtimed outやCould not find a valid gemが出たときの対処法
10. Redmine用のデータベース作成
以下のコマンドでmysqlにアクセス後、テーブル作成のSQLを発行します。
※アクセスするユーザはテーブル作成の権限があること
$ mysql -u [ユーザ名] -h [ホスト名(localhost)] -p
> create database redminedb
11. Redmineのインストール
$ svn co https://svn.redmine.org/redmine/branches/4.2-stable /var/lib/redmine
12. Redmine使用時のデータベースへの接続設定
下記の内容でRedmineのインストールディレクトリ/var/lib/redmine/直下に/config/database.yml/を作成します。
production:
adapter: mysql2
database: redminedb
host: localhost
username: <ユーザ名>
password: "<パスワード>"
encoding: utf8
14. gemパッケージのインストール
$ cd /var/lib/redmine
$ bundle install --without development test --path vendor/bundle
15. セッション改ざん防止用秘密鍵の作成
$ bundle exec rake generate_secret_token
16. データベースのテーブル作成
database.ymlで指定したデータベースにテーブルを作成します。
$ RAILS_ENV=production bundle exec rake db:migrate
17. デフォルトデータの登録
$ RAILS_ENV=production REDMINE_LANG=ja bundle exec rake redmine:load_default_data
18. Passengerのインストール
$ gem install passenger -v 5.1.12 --no-rdoc --no-ri
19. PassengerのApache用モジュールのインストール
opensslとの共存はできないため、インストール済みの場合は削除してからモジュールのインストールを行います。
($ yum remove openssl openssl-devel)
$ passenger-install-apache2-module --auto --languages ruby
20. Apache用設定内容確認
次の21.Apacheの設定で使用するための設定を出力します。
$ passenger-install-apache2-module --snippet
21. Apacheの設定
以下の内容で、/etc/httpd/conf.d/redmine.confを作成します。
#で記載のコメントの部分は省略可。
<Directory "/var/lib/redmine/public">
Require all granted
</Directory>
# 下記の５行は
# passenger-install-apache2-module --snippet で表示されたものを使用してください。
#
# LoadModule passenger_module /opt/rh/rh-ruby24/root/usr/local/share/gems/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so
# <IfModule mod_passenger.c>
# PassengerRoot /opt/rh/rh-ruby24/root/usr/local/share/gems/gems/passenger-5.1.12
# PassengerDefaultRuby /opt/rh/rh-ruby24/root/usr/bin/ruby
# </IfModule>
PassengerMaxPoolSize 20
PassengerMaxInstancesPerApp 4
PassengerPoolIdleTime 864000
PassengerStatThrottleRate 10
Header always unset "X-Powered-By"
Header always unset "X-Runtime"
Alias /redmine /var/lib/redmine/public
<Location /redmine>
PassengerBaseURI /redmine
PassengerAppRoot /var/lib/redmine
</Location>
その後、下記のコマンドでApacheを再起動します。
$ sudo systemctl restart httpd
22. Apache上でPassengerを動作させるための設定
Redmineのディレクトリに権限を付与します。
$ sudo chown -R apache:apache /var/lib/redmine
また、RedmineのURL設定を行い、設定を反映させます。
$ vi /etc/httpd/conf.d/redmine.conf
==========
Alias /redmine /var/lib/redmine/public
<Location /redmine>
PassengerBaseURI /redmine
PassengerAppRoot /var/lib/redmine
</Location>
==========
$ sudo service httpd configtest
$ sudo systemctl restart httpd
23. Redmineログイン
ブラウザのURLに「(RedmineをインストールしたIPアドレスまたはホスト名)/redmine」を入力し、アクセスします。
Redmineのログイン画面が表示されたら、環境構築完了!! お疲れさまでした!!
さいごに
ここまで長い道のりだったと思います。私は下記の記事を参考に構築しましたが、
RedmineやRubyのバージョンの違いに苦しみました。。。エラーが山盛りでましたね。
この記事もいつかは古くなりコピペでは構築できないことも出てくるのでしょう。
最後に記載すべきではないかもしれませんが、Dockerを使った方が楽です。
私は現在Dockerを利用してRedmineを使っています。。。(ここまで付き合ってくれた方は申し訳ないです。)
もしかしたら何かしらの制約でDockerは使えないけどRedmineは使いたいよーっという人には需要があるかもしれないですね。
Dockerを利用した構築方法もどこかで記事にしたいと思います。