Redmine

Linux

Table of Contents

リンク

インストール

環境

ソフトウェア バージョン
Redmine Redmine 3.3.2
OS CentOS 7.3
データベース MariaDB 5.5.52
webサーバ Apache 2.4.6
Ruby Ruby 2.0.0
Passenger Passenger 5.1.2
バージョン管理システム Git 1.8.3.1

パッケージのインストール

  • 開発環境 

    # yum -y groupinstall "Development Tools"
# yum -y install openssl-devel readline-devel zlib-devel curl-devel libyaml-devel libffi-devel

  • Ruby (CentOS-Base リポジトリ) 

    # yum -y install ruby ruby-devel

  • MariaDB 

    # yum -y install mariadb-server mariadb-devel

  • Apache 

    # yum -y install httpd httpd-devel

  • ImageMagickとヘッダファイル・日本語フォント 

    # yum -y install ImageMagick ImageMagick-devel ipa-pgothic-fonts

  • bundler 

    # gem install bundler --no-rdoc --no-ri

MariaDB

  • /etc/my.cnf (抜粋) 
    [mysqld]
character-set-server=utf8

[mysql]
default-character-set=utf8
  • 起動 & サービス登録 
    # systemctl start mariadb
# systemctl enable mariadb
  • 設定確認 
    # mysql -u root
> show variables like 'character_set%'; (filesystem と dir 以外全てが utf8 になっていること)
+--------------------------+----------------------------+
| Variable_name            | Value                      |
+--------------------------+----------------------------+
| character_set_client     | utf8                       |
| character_set_connection | utf8                       |
| character_set_database   | utf8                       |
| character_set_filesystem | binary                     |
| character_set_results    | utf8                       |
| character_set_server     | utf8                       |
| character_set_system     | utf8                       |
| character_sets_dir       | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+
> exit
  • 初期設定 
    # mysql_secure_installation
...
Enter current password for root (enter for none): (そのままエンター)
...
Set root password? [Y/n] (y応答)
New password: (新 root パスワードを入力)
Re-enter new password: (パスワード再入力)
...
Remove anonymous users? [Y/n] (y応答)
...
Disallow root login remotely? [Y/n] (y応答)
...
Remove test database and access to it? [Y/n] (y応答)
...
Reload privilege tables now? [Y/n] (y応答)
  • Redmine用データベースとユーザーの作成 
    # mysql -u root -p
> create database db_redmine default character set utf8;
> grant all on db_redmine.* to user_redmine@localhost identified by '********';
(******** は user_redmine 用のパスワードを記述する)
> flush privileges;
> exit;

Redmine のインストール

  • GitHub:redmine/redmine 
    # curl -L -o redmine_3.3.2.zip https://github.com/redmine/redmine/archive/master.zip
# unzip redmine_3.3.2.zip
# mv redmine-master/ /var/lib/redmine
  • /var/lib/redmine/config/database.yml 
    production:
  adapter: mysql2
  database: db_redmine
  host: localhost
  username: user_redmine
  password: "********"
  encoding: utf8
  • /var/lib/redmine/config/configuration.yml 
    production:
  email_delivery:
    delivery_method: :smtp
    smtp_settings:
      address: "localhost"
      port: 25
      domain: "example.com"

  rmagick_font_path: /usr/share/fonts/ipa-pgothic/ipagp.ttf

gemパッケージのインストール

# cd /var/lib/redmine
# bundle install --without development test --path vendor/bundle

Passenger のインストール (mod_passenger)

  • Installing Passenger + Apache on Red Hat 7 / CentOS 7 (with RPM) - Passenger Library 

    # yum install pygpgme curl
# curl --fail -sSLo /etc/yum.repos.d/passenger.repo https://oss-binaries.phusionpassenger.com/yum/definitions/el-passenger.repo
# yum install -y mod_passenger || yum-config-manager --enable cr && yum install -y mod_passenger
# /usr/bin/passenger-config validate-install (設定確認)
# systemctl restart httpd
# /usr/sbin/passenger-memory-stats

  • /etc/httpd/conf.d/passenger.conf 

    ### Begin automatically installed Phusion Passenger config snippet ###
<IfModule mod_passenger.c>
   PassengerRoot /usr/share/ruby/vendor_ruby/phusion_passenger/locations.ini
   PassengerRuby /usr/bin/ruby
   PassengerInstanceRegistryDir /var/run/passenger-instreg
</IfModule>
### End automatically installed Phusion Passenger config snippet ###

# Deploying a web application: an example

# Suppose you have a web application in /somewhere. Add a virtual host to
# your Apache configuration file and set its DocumentRoot to /somewhere/public:

<VirtualHost *:80>
    ServerName redmine.example.com
    # !!! Be sure to point DocumentRoot to 'public'!
    DocumentRoot /var/lib/redmine/public
    <Directory /var/lib/redmine/public>
        # This relaxes Apache security settings.
        AllowOverride all
        # MultiViews must be turned off.
        Options -MultiViews
        # 画像ファイル・CSSファイル等へのアクセスを許可する
        Require all granted
    </Directory>
</VirtualHost>

# Passengerが追加するHTTPヘッダを削除するための設定（任意）。
Header always unset "X-Powered-By"
Header always unset "X-Runtime"

# 必要に応じてPassengerのチューニングのための設定を追加（任意）。
# 詳しくはPhusion Passenger users guide(https://www.phusionpassenger.com/library/config/apache/reference/)参照。
PassengerMaxPoolSize 20
PassengerMaxInstancesPerApp 4
PassengerPoolIdleTime 864000
PassengerHighPerformance on
PassengerStatThrottleRate 10
PassengerSpawnMethod smart
PassengerFriendlyErrorPages off

  • Deploying a Ruby application - Apache - Passenger Library

初期設定

# 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

SELinux

  • Fedora Manpages: passenger_selinux(8)
  • ~/SetSecurityFlags.sh 
    #!/bin/bash

chown -R apache. /var/lib/redmine
chcon -Rh -t httpd_sys_content_t /var/lib/redmine
cd /var/lib/redmine
chcon -Rh -t httpd_log_t log
chcon -Rh -t httpd_tmpfs_t tmp
chcon -Rh -t httpd_sys_rw_content_t files public/plugin_assets
find . -name '*.so' | xargs -i chcon -Rvh -t httpd_modules_t {}

# リポジトリとして使用するフォルダ
chcon -Rh -t public_content_t /home/Shared/

起動 & サービス登録

# firewall-cmd --add-service=http --permanent
# firewall-cmd --reload
# systemctl start httpd
# systemctl enable httpd

カスタマイズ

設定

  • 「管理 - 設定」から各項目を変更。
  • 表示
    • 日付の形式: yyyy-mm-dd
    • 時刻の形式: hh:mm (24時制)
  • チケットトラッキング
    • 現在の日付を新しいチケットの開始日とする: チェック外す
    • 進捗の算出方法: チケットのステータスに連動
  • メール通知
  • リポジトリ
    • 参照用キーワード: 「*」を追加。(参照用キーワード無しでリビジョンとチケットを関連づける)

トラッカー

  • 「機能, サポート, バグ」に順序を変更。

チケットのステータス

  • ステータス更新後、「進捗率の更新」をクリック。 | ステータス | 進捗率 | 終了したチケット | | --- | --- | --- | | 新規 | | | | 進行中 | 50 | | | 解決 | 100 | v | | フィードバック | 70 | | | 終了 | 100 | v | | 却下 | 100 | v |

プラグイン

  • GitHub:yukkyna/redmine-export-project-data
    • プロジェクト一式をファイルとしてエクスポートする。
    • エクスポート 
      # cd /var/lib/redmine/
# RAILS_ENV=production rake 'project_data:export[identifier,destdir]'
    • インポート
# cd /var/lib/redmine/
# cp -R destdir/files/ .
# chown -R apache. files/
# chcon -Rh -t httpd_sys_content_t files/
# cat destdir/identifier.sql | mysql -u user_redmine -p db_redmine

Home