Redmine学习

简介（Introduction）

Redmin是一款项目管理系统，可以为项目成员提供一站式的服务，例如项目wiki，文档列表，bug管理，backlogs，甘特图，日历等等。

项目组的所有角色都可以使用Redmine来管理自己感兴趣的部分。Redmine另一个优势是可以添加许多功能强大的插件

预安装(Pre-install)

Redmine是用Ruby on Rails开发的，自己动手安装Redmine是一件很复杂的事，因为在安装过程中有很多依赖的库，而某些库又有一些非常严格的版本兼容问题。

这不是Redmine自己的问题，大部分基于RoR框架的web项目都有这个问题。

BITNAMI的方便之处就在于其免费提供多种web应用从OS到运行平台（虚拟机）到框架（例如Rails）到web应用（Redmine)以及数据库等的运行环境包，所有的依赖库和版本兼容问题BITNAMI都已经解决完毕。开发人员可以直接下载，通过非常简单的安装，即可运行使用。从这里可以在BITNAMI上找到不通OS下的Redmine运行包。

注：BITNAMI上免费提供的Web应用不局限于Rails产品，具体内容详见官网。

安装（Install）

以Ubuntu为例。

1. 解压从BITNAMI下载好的安装包。例如解压到路径：~/Downloads/redmine/bin

2. 运行Shell脚本manager-linux-x64.run，按照图形提示界面安装即可，这期间需要创建管理员帐号和密码。

   注： 在Redmine安装的根目录下的脚本ctlscript.sh包含一些控制命令，如restart，start，stop等。

3. 在安装结束后，打开浏览器，输入localhost:8080/Redmine，即可打开Redmine。可以自己新建一个项目玩一玩，Redmine默认安装并加载的模块有：问题跟踪，时间跟踪，新闻，文档，文件，Wiki，版本库，讨论区，日历，甘特图。有些模块需要配置以后才可使用。

配置(Configuration)

1. 版本库配置

Redmine的代码库（Repository）是Redmine自带的一个功能，目前可以支持SVN，CVS，Git等多种版本管理系统，有些版本库需要下载一些依赖支持。

    Git配置

在Redmine中配置Git，可以参考Redmine官方wiki，但是该wiki中有一个错误：

Now go to your Redmine project settings, go to the repositories tab and choose git as the SCM, then put in the Path to repository (in our example this is /var/redmine/git_repositories/donebox.git/) and save the settings.

其实要填到版本库里面的path不是存放代码的根目录，而是.git隐藏目录。

例如项目目录是：myproject/HelloRedmine/，HelloRedmine目录下面就是src,bin等目录了。

那么需要填到版本库里面的path就是：myproject/HelloRedmine/.git

插件（Plugins)

1. Backlogs

http://www.redminebacklogs.net/en/installation.html#

http://www.ruby-forum.com/topic/703056