一款轻量级的项目管理工具Redmine

我是个懒人，以前一直没考虑在独立开发中使用项目管理工具。记录工作进度，项目需求及功能，测试结果，我都用vi编辑文本管理的很好。不过最近由于项目进度的深入，发现文本编辑不够用了。文本无法解决的问题是: 一项类似流程的工作，它的状态会随着时间推移发生变化，明确的例子包括bug跟踪，需求变化等等。

我在网上搜了一下，有不少工具可以选择。比如以下两篇提到的：

Top 10 Open Source Bug Tracking System

10 Must-Have Personal Project Management Tools

收费的企业级工具像JIRA，在前东家使用过，团队开发用起来还算方便，听说Amazon也在用。还有开源界大名鼎鼎的Bugzilla, 在主流开源社区广泛使用

我对工具的基本需求：Bug跟踪，功能记录，要是有每项任务工作时间的记录就更好了。最后选择了Redmine，它用Ruby开发，web应用运行在rails上; 后端的数据库可选择MySQL，PostgreSQL, MS SQLServer; 界面简洁不花哨，账户管理简单清晰。最重要的是，它号称支持项目管理的全过程，同时开发社区还比较活跃，比较适合独立开发者及小型团队。

Redmine主页就是用Redmine搭建的，有兴趣的同学可以率先感受一下UI。平心而论，它的安装帮助文档写的不算粗糙，基本步骤没有缺失。不过在实际安装中，由于是Ruby小白，我整个过程花了四个多小时，还是发现了一些额外的安装细节，所以在这里跟大家分享一下。

注：2017.9 根据最新的各软件版本，对下列步骤描述中涉及的软件版本作了相应更新。

我的安装环境是Ubuntu16.04 LTS，本机运行。阅读本文时，请同时参照官方的在线帮助文档Redmine Fresh Installation。文档中把安装分成10个步骤，下文中沿用它的步骤编号，有额外补充的，会加以说明。

Redmine安装前，准备好数据库。根据版本依赖关系，我选择安装了MySQL 5.7，有root权限。

step 1. 下载Redmine安装包。

>> 我选择了Redmine3.4.1

step 2.在数据库中创建新库，新表，和用户

>> 参见MySQL部分

step 3. 修改Redmine配置文件中数据库相关部分

step 4. 依赖包的安装

>> 这一步是我花费时间较多的。官方文档里它就两行：

$ gem install bundler
$ bundle install --without development test

可实际上，在这"bundle install"往往会失败，它提示要求安装 mysql2 ‘0.x.x‘。经过查找和尝试，这货安装前还需要安装以下 lib:

$ apt-get install libtool
$ apt-get install ruby-mysql libmysqlclient-dev

然后，才轮到mysql2。如果用gem安装mysql2失败，可试试apt安装ruby-all-dev依赖包先。

$ apt-get install ruby-all-dev  // optional
$ gem install mysql2 -v '0.x.x'

现在可以运行‘bundle install’了？错，bundle还会继续提示你需要安装rmagick. 所以，你还需要以下步骤：

$ apt-get install libmagickwand-dev
$ gem install rmagick -v '2.14.0

到这，终于可以bundle install了

$ bundler install --without development test

如果没能成功安装rmagick， 也没关系，可以在bundler install命令里去除rmagick项

$ bundler install --without development test rmagick

step 5.

...

step 9.启动Redmine。官方给的命令是：

<redmine dir>$ bundle exec ruby script/rails server webrick -e production

不过，实际成功的命令，需要调用的是bin/rails:

<redmine dir>$ bundle exec ruby bin/rails server [-d] webrick -e production

默认方式是在终端里以应用的方式启动Redmine, 终端关闭Redmine也就关闭了。[-d] 参数就是以daemon方式启动它。

OK，大功告成。如果你没有改过默认端口，登录localhost: 3000去访问它吧。

使用Redmine几天，已经感觉开发的效率提高了不止一点两点啊。所以，工欲善其事，必先利其器！