Redmine项目管理的安装及配置

Redmine是什么

Redmine 是一个网页界面的项目管理与缺陷跟踪管理系统的自由及开放源代码软件工具。它集成了项目管理所需的各项功能：日历、燃尽图和甘特图以协助可视化表现项目与时间限制，问题跟踪和版本控制。此外，Redmine也可以同时处理多个项目。
Redmine是以Ruby on Rails撰写的架构，它横跨多个平台与数据库，它的设计很明显是受一些类似功能软件包的Trac所影响。

安装过程

Redmine对我来说，是一个特别陌生的工具，之前也没有使用过的经历，但是因为单位项目管理的需求，需要安装一下这个软件。几个同事也试过，但是总会因为这些那些的原因，导致还是没能顺利安装。其实网上有特别多的教程，但是几乎没有一个能用的，我在安装过程中也遇到特别多的困难，但是最终却发现其实官网的教程反而是最可靠的，于是顺利安装，有了下面这个教程。

下载安装包

目前最新的包是redmine-3.2.1.tar.gz

设置数据库

我使用的是mysql，因此需要建立相应数据库、redmine用户、设置访问权限：

1
2
3
REATE DATABASE redmine CHARACTER SET utf8;
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';

还需要配置相应的数据库配置文件，先解压安装包：

1
2
3
4
tar zxf redmine-3.2.1
cd redmine-3.2.1/config/
mv database.yml.example database.yml
vim database.yml

修改如下的配置：

1
2
3
4
5
6
production:
  adapter: mysql2
  database: redmine
  host: localhost
  username: redmine
  password: my_password

安装Ruby环境及Gem

安装Redmine需要用到Ruby和Gem，

1
2
3
curl -L https://get.rvm.io | bash
source /etc/profile.d/rvm.sh
rvm install 2.3.0

配置环境

这里需要使用到Bundler来安装，执行一下命令：

1
2
gem install bundler
bundle install --without development test rmagick

在安装过程中如果报错，或缺失某些包，可编辑Gemfile，修改第一行为淘宝源：

1
source 'https://ruby.taobao.org'

配置rake

在执行redmine服务的时候，需要用到该服务，执行以下命令，生成一些必须文件：

1
bundle exec rake generate_secret_token

创建数据库初始信息

1
RAILS_ENV=production bundle exec rake db:migrate

默认数据库设置

1
RAILS_ENV=production bundle exec rake redmine:load_default_data

设置文件系统权限

1
2
3
mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R redmine:redmine files log tmp public/plugin_assets
sudo chmod -R 755 files log tmp public/plugin_assets

试运行

执行下面一行命令可以将redmine运行在http://localhost:3000

1
bundle exec rails server webrick -e production

初始redmine帐号为admin，密码也是admin，如果测试成功，那么到这里就成功安装了该软件。

正式环境配置

正式环境需要将webrick在后台运行，并且可能还需要监听0.0.0.0，而不是127.0.0.1，因此可能还需要用到如下的命令，并将其加入到开机执行脚本中，这样将每次开机时自动开启。

1
cd /path/to/redmine-3.2.1/ && bundle exec rails server -b 0.0.0.0 webrick -e production -d

配置邮箱通知服务

修改config/configuration.yml文件，加入如下配置：

1
2
3
4
5
6
7
8
9
10
default:
  email_delivery:
      delivery_method: :smtp
      smtp_settings:
        address: "smtp.yourdomain.com"
        port: 25
        authentication: :login
        domain: 'yourdomain.com'
        user_name: 'username@yourdoain.com'
        password: 'yourpassword'

至此，redmine服务配置就完成了，接下来只需要登录http://ip:3000，在界面上根据步骤配置即可。