Redmineのプラグインを保守するにあたって、ノートPCへRedmineの環境を作成しました。今までbitnamiのWindows用インストーラーを使って開発環境を作成してきたのですが、正直しんどくなってきました。
何度かLinuxのサーバーをVM上で作成して環境作ってみたものの、失敗に失敗を重ねて挫折したままでしたが、コロナの影響もあり勤務時間が多少短くなったのを機に、開発用環境づくりに再チャレンジしています。
当記事は、その時の手順を記録した、個人的な備忘記事です。今後何度かチャレンジして修正していくつもり。
ちなみに、私はlinuxをほとんど触ったことがない初心者。色々webで調べてもすべてが呪文のように見えてしまうレベルです。
今後この記事を修正したい点
-
CentOSのインストール方法を詳細化
なんとなく上手くできただけっぽいので手順をちゃんと残しておきたい -
ファイアーウォールの設定とMySQLの設定
bitnamiのVMを使ってredmineをノートPCにインストールした際に、MySQLを外部アクセスできるようにできなかったため要勉強。
利用した環境、ツール
Windows10 home 64bit (AMD)
Oracle VM Virtualbox
CentOS8(CentOS-8.1.1911-x86_64-dvd1.iso)
Redmine4.1
Ruby2.7
参考にしたサイト
初期設定 : ファイアウォール
初期設定 : SELinux
https://www.server-world.info/query?os=CentOS_8&p=initial_conf&f=2
[CentOS] CentOS8.1を新規インストールしてRedmine4.1環境作成
https://vertys.net/centos-install-newly-and-create-redmine-environment/
CentOS8のインストール
サーバーはOracle VM VirtualBoxを使って作りました。
最小構成で作成しています。これは難なくクリア。
CentOS8の諸設定
上記のサイトを参考に、SELinuxの無効化、ファイアーウォールの無効化をしました。
開発目的で利用するため、かつ、MySQLをゲストからアクセスしていじりたかったので、設定が面倒そうなファイアーウォールを無効化しました。もう少し時間があったら、ちゃんと設定したい。
CentOS8の最新化
Teratermでサーバーにrootでログイン
cd ..
yum update
開発用ツールのインストール
ここからは参考にしたサイトと同じ手順で実施。
dnf -y install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
dnf -y install https://rpms.remirepo.net/enterprise/remi-release-8.rpm
dnf -y groupinstall "Development Tools"
dnf -y install openssl-devel readline-devel zlib-devel curl-devel libffi-devel
Subversionのインストール
Redmineをインストールする際にSubversionを使うため。
dnf module -y install subversion
MySQLのインストール
dnf -y install @mysql:8.0 mysql-devel
Apacheのインストール
dnf -y install httpd httpd-devel
Rubyのインストール
このパートは結構時間がかかりました。
curl -O https://cache.ruby-lang.org/pub/ruby/2.7/ruby-2.7.0.tar.gz
tar xvf ruby-2.7.0.tar.gz
cd ruby-2.7.0
./configure --disable-install-doc
make
make install
インストール後の確認
ruby -v
ruby 2.7.0p0 (2019-12-25 revision 647ee6f091) [x86_64-linux]
と出ればOK
Bundllerのインストール
gem install bundler
MySQLの設定
systemctl enable mysqld
systemctl start mysqld
mysql_secure_installation
聞かれた質問には以下のように回答していく
Press y|Y for Yes, any other key for No: y
※VALIDATE PASSWORDを変更するのでy
Please enter 0 = LOW, 1 = MEDIUM and 2 = STRONG: 0
※開発で使いたいだけなのでLOW
New password:（設定したいパスワードを入力）
Re-enter new password:（設定したいパスワードを再入力）
Do you wish to continue with the password provided?(Press y|Y for Yes, any other key for No) : y
※設定したパスワードで続行するのでy
Remove anonymous users? (Press y|Y for Yes, any other key for No) : y
※匿名ユーザーは不要なのでy
Disallow root login remotely? (Press y|Y for Yes, any other key for No) : y
※rootでリモートログインはしないのでy
Remove test database and access to it? (Press y|Y for Yes, any other key for No) : y
※テスト用のデータベースは不要なのでy
Reload privilege tables now? (Press y|Y for Yes, any other key for No) : y
※ここまでの設定を反映させたいのでy
Redmine用MySQLのユーザー作成と権限付与
MySQLにログインしてみます。上記で設定したPASSWORDを入力になります
mysql -u root -p
redmineが利用するユーザーを作成します。ここで設定したパスワードは後のどRedmineの設定で使います。
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'DBのパスワード';
権限を付けます。このユーザーがアクセスするのは仮想サーバー内からだけ。外部からアクセスするためのユーザーは後で作成します。
GRANT ALL ON *.* TO 'redmine'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
CREATE DATABASE redmine CHARACTER SET utf8mb4;
exit
Redmineのインストール
SubversionのレポジトリからRedmineを取得する。
cd /var/lib
mkdir redmine
svn co https://svn.redmine.org/redmine/branches/4.1-stable /var/lib/redmine
RedmineのDBアクセスの設定ファイルを作成する
vi /var/lib/redmine/config/database.yml
以下の内容を追記
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: "DBのパスワード"
encoding: utf8mb4
依存パッケージのインストール
cd /var/lib/redmine
bundle install --without development test --path vendor/bundle
Redmine関連の初期設定
bundle exec rake generate_secret_token
RAILS_ENV=production bundle exec rake db:migrate
MigrationしたときにWarningが結構な数出たが先に進む。
Passengerのインストール
gem install passenger -v 5.1.12
passenger-install-apache2-module --auto --languages ruby
Apacheの設定
Redmine用のApche設定に必要な情報を以下のコマンドで表示させる
passenger-install-apache2-module --snippet
設定ファイルの作成
vi /etc/httpd/conf.d/redmine.conf
スニペットでの内容とともに以下の記述を追記
Alias /redmine /var/lib/redmine/public
<Location /redmine>
PassengerBaseURI /redmine
PassengerAppRoot /var/lib/redmine
</Location>
<Directory "/var/lib/redmine/public">
Require all granted
</Directory>
LoadModule passenger_module /usr/local/lib/ruby/gems/2.7.0/gems/passenger-5.1.12/buildout/apache2/mod_passenger.so
<IfModule mod_passenger.c>
PassengerRoot /usr/local/lib/ruby/gems/2.7.0/gems/passenger-5.1.12
PassengerDefaultRuby /usr/local/bin/ruby
</IfModule>
systemctl enable httpd
systemctl start httpd
所有者apacheへ変えておく
chown -R apache:apache /var/lib/redmine
Redmineの確認
http://（サーバのIPアドレス）/redmine
で画面が表示されるか確認。
ユーザー：admin
pass：admin
ログイン後は好きなように設定変更
開発しているプラグインの導入
開発しているプラグインを導入する。migrationをする際にwarningがいっぱい出る。
cd /var/lib/redmine/plugins
git clone https://github.com/momibun926/redmine_issue_evm /var/lib/redmine/plugins/redmine_issue_evm
bundle install
rake redmine:plugins:migrate NAME=redmine_issue_evm RAILS_ENV=production
chown -R apache:apache /var/lib/redmine
Gitの設定
コミットした時のユーザーが、OSのログインユーザーになってしまうため、Gitの設定をしておく。
git config --global user.email e-mailアドレス
git config --global user.name "ユーザー名"
MySQLを外部からアクセスできるようにする
プラグイン作成時にDBの値をいじりながら挙動を確認したいことがあるので、MySQLにホスト側（Window10）から接続したい。使っているツールはA5MK2です。
MYSQLにrootで入ります。
mysql -u root -p
外部アクセス用のユーザーを作成。本来は%のところをノートPCのIPで指定したほうが良いのだと思う。
CREATE USER 外部接続ユーザー IDENTIFIED BY '外部接続ユーザーのためのパスワード';
grant all privileges on *.* to 外部接続ユーザー@'%';
これで、ホスト側から外部接続のユーザー、パスワード使ってアクセスが可能になる。
ファイアーウォールを使っている場合は、別途ファイアーウォールの設定も必要。
Visual studio codeでリモート接続
ssh接続用の設定に以下のようなエントリを追加して接続
Host Redmine4.1-CentOS8(MySql)
HostName CentOSのIP
Port 22
User アクセスするユーザー
Redmineの再起動
開発しているときは度々Redmineを再起動する必要が出てくるので以下コマンドをVisualStudioCodeのターミナルで入力してブラウザをリロードすると再起動する。
touch /var/lib/redmine/tmp/restart.txt
これで、コーディング、確認を繰り返しながら開発できる。
本来ならば、テストコード書きながらテスト実行が良いのですが、Redmineのプラグインならこの繰り返しで何とかなりそう。
ただし、テストコードがないとリファクタリングや機能の改善後のデグレテストが非常に大変。railsのチューとリアルでもやっておけばよかったと今更後悔している。そのうちテストコードが書けるようになったら、テストコードの記事も書きたい。