概要
自分のメインPC内にRedmineを構築し、個人開発のチケット管理に利用します。
他のチケット管理ステムも利用しましたが、やはり無料アカウントでは限界があるのと、メインPCのリソース有効活用（特にストレージ容量は余る傾向にあります）のため、これを利用することにしました。
自分のPC内でグローバルからのアクセスも考慮していないため、なるべくお手軽設計となっています。
ローカルのGitの内容も見ることができますが、より詳細にGitを管理するならGitLabを入れるなど、追加の対応が必要になると思います。
動作環境
- Ubuntu: 22.04 LIS
- CPU: AMD Ryzen 5600G
- メモリ: 32GB
上記の環境内に構築した 24.04 LIS LXDコンテナに構築します。
事前準備
Rubyのインストール
以前書いたこちらの記事を参考にインストールします。
PostgreSQL のインストールをあらかじめ実施
apacheは使用せずに構築します。
SQLiteを使用すれば更に手間を削減できますが、別用途にも使用するので今回はPostgreSQLを使用します。
- 公式リポジトリの設定
apt install -y postgresql-common
/usr/share/postgresql-common/pgdg/apt.postgresql.org.sh
- インストール(16)
apt update
apt install postgresql-16
- 設定の調整
必要最低限の設定を行います。
/etc/postgresql/16/main/postgresql.conf
listen_addresses = '0.0.0.0'
max_connections = 1000
shared_buffers = 512MB
maintenance_work_mem = 128MB
work_mem = 16MB
log_destination = 'stderr'
log_directory = 'log'
log_filename = 'postgresql-%Y-%m-%d_%H%M%S.log'
log_file_mode = 0600
log_rotation_age = 1d
autovacuum = on
autovacuum_naptime = 1min
設定を反映させ、自動起動するようにします。
systemctl daemon-reload
systemctl enable postgresql
systemctl restart postgresql
systemctl status postgresql
関連パッケージのインストール
apt install unzip
専用ユーザーを作成( redmiusr )
Redmine用のデータベースを作成
su - postgres
createuser -P redmiusr
pass: ＜パスワード＞
createdb -E UTF-8 -l ja_JP.UTF-8 -O redmiusr -T template0 RedmineDB
Redmineのダウンロードと配置
ダウンロード
wget https://www.redmine.org/releases/redmine-5.1.3.zip
解凍して配置します。
mkdir redmine
cd redmine/
unzip ../redmine-5.1.3.zip -d ./
mv redmine-5.1.3 bin
cd bin
各設定ファイルを編集
configの設定ファイルを編集します。
DB情報
設定ファイルをコピー
cp config/database.yml.example config/database.yml
設定を編集しPostgreSQLの設定を行います。
config/database.yml
# PostgreSQL configuration example
production:
adapter: postgresql
database: RedmineDB
host: localhost
username: redmiusr
password: "＜パスワード＞"
encoding: utf8
Railsの設定
config/application.rb
# メールを使わない
config.action_mailer.perform_deliveries = false
config/configuration.yml
production:
email_delivery:
delivery_method: :smtp
smtp_settings:
address: “localhost”
port: 25
domain: “sample.com” ※redmineを実行するサーバーのFQDN
rmagick_font_path: /usr/share/fonts/truetype/usr/share/fonts/truetype/noto/NotoSans-Regular.ttf
ログローテション
ローカル配置でも、不具合があった際に原因を探れるようにログは出力したほうがいいです。
日付でローテーションもできますが、古いログの削除を別で実装する必要があって面倒なので、ファイルサイズでローテーションを行います。
config/environments/production.rb
# 5Mになったらローテションして10個前は削除
config.logger = Logger.new('log/production.log', 10, 5 * 1024 * 1024)
# 日付でローテションする方法もあるが、削除をしてくれない
#config.logger = Logger.new('log/sample.log', 'daily')
インストール
スクリプトを実行
bundle config set --local path 'vendor/bundle' --without production
bundle install --path vendor/bundle
bundle exec rake generate_secret_token
データベースのテーブル作成
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production REDMINE_LANG=ja bundle exec rake redmine:load_default_data
テストでサーバーを起動
bundle exec rails server -e production
ポート番号やLISTENするIPを変更するには以下のようにしたほうが
bundle exec rails server -e production -b 0.0.0.0 -p 3000
初期ログイン
初期管理者IDは以下となります。
login: admin
password: admin
初期パスワードは変更してください。
また、実際にチケットの管理を行う別ユーザーを作成しておきます。
Redmineのデーモン化
デーモン化し、コンテナ起動時に自動で起動するようにします。
スクリプトを作成
~/redmine/redmine.sh
#!/usr/bin/bash
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"
cd ~/redmine/bin
bundle exec rails server -e production -b 0.0.0.0 -p 3000
実行権限を付けておきます。
chmod 700 ~/redmine/redmine.sh
systemdの設定ファイルを作成します。
/etc/systemd/system/redmine.service
[Unit]
Description=Redmine
After=network.target
[Service]
#WatchdogSec=10
User=redmine
Type=simple
WorkingDirectory=/home/redmine/redmine/bin/
ExecStart=/home/redmine/redmine/redmine.sh
[Install]
WantedBy=multi-user.target
アクセス権を修正し書式の確認します。
chmod 644 /etc/systemd/system/redmine.service
systemd-analyze verify /etc/systemd/system/redmine.service
起動設定を行います。
systemctl daemon-reload
systemctl enable redmine
systemctl start redmine
systemctl status redmine
バックアップ
バックアップ用のスクリプトを作成します。
ディレクトリを作成
mkdir /root/bkscript
バックアップスクリプトを配置します。
/root/bkscript/redmine-bk-pg.sh
#!/usr/bin/bash
mkdir /root/bkscript/redmine-bk
# postgreSQL
pg_dump -U redmiusr -h localhost -Fc --file=/root/bkscript/redmine-bk/pg-RedmineDB`date +%Y%m%d`.sql RedmineDB
# Redmine file
cp -pr /home/redmine/redmine/bin/files /root/bkscript/redmine-bk/
rsync -ahv /home/redmine/redmine/bin/config/ /root/bkscript/redmine-bk/config --exclude "locales"
# system file copy
cp -p /home/redmine/redmine/redmine.sh /root/bkscript/redmine-bk/
cp -p /etc/systemd/system/redmine.service /root/bkscript/redmine-bk/
cp -p /root/script/redmine-bk-pg.sh /root/bkscript/redmine-bk/
cp -p /root/.pgpass /root/bkscript/redmine-bk/dot_pgpass
# tar and move
tar -pzcf /root/script/redminebk-1.tar.gz /root/bkscript/redmine-bk
rm -rf /root/bkscript/redmine-bk
mv /home/bk-redmine/redminebk-6.tar.gz /home/bk-redmine/redminebk-7.tar.gz
mv /home/bk-redmine/redminebk-5.tar.gz /home/bk-redmine/redminebk-6.tar.gz
mv /home/bk-redmine/redminebk-4.tar.gz /home/bk-redmine/redminebk-5.tar.gz
mv /home/bk-redmine/redminebk-3.tar.gz /home/bk-redmine/redminebk-4.tar.gz
mv /home/bk-redmine/redminebk-2.tar.gz /home/bk-redmine/redminebk-3.tar.gz
mv /home/bk-redmine/redminebk-1.tar.gz /home/bk-redmine/redminebk-2.tar.gz
mv /root/script/redminebk-1.tar.gz /home/bk-redmine/
実行権限を付けておきます。
chmod 700 /root/bkscript/redmine-bk-pg.sh
DBアカウントの設定を行います。
~/.pgpass
localhost:5432:RedmineDB:redmiusr:<<パスワード>>
アクセス権を修正します。
chmod 0600 ~/.pgpass
最後にcronの設定を行います。
crontab -e
10 13 * * * /root/bkscript/redmine-bk-pg.sh
確認
crontab -l
バックアップからのリストア
PostgreSQLのインストールとDBの作成
RubyのインストールとRedmineのダウンロードと展開まで実施
バックアップを解凍します。
tar -pzxvf /home/bk-redmine/redminebk-1.tar.gz
confをコピーします。
また、filesを移動します。
mv ../../work/root/bkscript/redmine/files/* files/
ビルド・インストールして空のものを新規作成します。
systemctl用やバックアップ用のスクリプトを設置します・
DBをいったん空にします。
su - postgres
dropdb RedmineDB
createdb -E UTF-8 -l ja_JP.UTF-8 -O redmiusr -T template0 RedmineDB
exit
pg_dumpからリストアします。
pg_restore -U redmiusr -h localhost -d RedmineDB <バックアップファイル>
起動して動作確認を行い、バックアップcronの設定をおこないます。
参考URL
公式サイト
参考資料