1. 简介
公司项目都上敏捷了,使用Notes讨论问题太不敏捷了,于是考虑一个敏捷项目管理工具,本文介绍的是使用BitNami方式安装redmine并配置邮件发送的方式。
BitNami提供redmine的一键安装程序,简单、易用、方便。
2. 安装
下载地址:https://bitnami.com/stack/redmine/installer
不仅仅是windows的有一键安装程序,linux也有一键安装程序。我的安装环境是windows server 2003,下载的版本是3.0.1-0,官方网站即可下载。
跟大部分windows安装程序一样,一路默认“下一步”即可。需要注意的是,创建管理员账号的时候,需要将用户名称和密码记录下来,此用户即为redmine安装好后的管理员账号,如下图 2‑1所示:
图2‑1 设置管理员账号信息
安装完后会自动打开浏览器,如下图 2‑2所示,点击“Access BitNami Redmine Stack”即可访问redmine。
图2‑2 安装成功
输入图 2‑1所示的管理员账号和密码,即可登录redmine。如下图 2‑3所示。开始体验吧。
图2‑3 管理员登录
3. 集成git
3.1. 新建版本库
登录redmine,添加用户,新建一个project,新建完成后,在配置->版本库中选择git,然后在”Path to .git repository”中写入git的路径即可(注意:需要包括.git所在的路径)。如下图 3‑1所示。
图3‑1 新建版本库
标准安装的redmine只能访问本地git版本库,不能通过git协议访问git版本库,我们可以通过git clone --mirror克隆镜像到本地的方法来解决。
3.2. 浏览版本库
添加完版本库后,即可在通过edmine在web上浏览版本库,选择项目 > 版本库,等待一下,让Redmine处理下Repository 的信息,然后就可以看到版本库了,如下图 3‑2所示:
图3‑2 浏览版本库
注意:当配置完版本库第一次访问时, Redmine将抓取版本库中已经存在的所有提交信
息, 并存入数据库。所以如果你的版本库特别大, 那么该过程将会很长。
3.3. git提交和redmine问题关联
要实现在gi代码提交的同时关闭问题状态,实现提交跟问题建立关联,需要以管理员身份登陆,依次选择“管理” > “配置” > “版本库”,按下图 3‑3所示设置,设置完点击保存。
图3‑3 提交和问题关联的设置
回到项目中,在项目里新建一个问题,新建完后,如下图所示:
图 3‑4 新建问题
修改代码,git提交信息中只要包含有“closes #1”字眼的,就会自动关闭问题。如下图 3‑5所示,在这里还可以看到某个bug对应改动的代码是什么。
图3‑5 git提交自动关闭问题
4. 邮件配置
使用Bitnami方式很快可以完成redmine的安装,但是到了配置邮件方式可郁闷坏了。网上找了一圈基本不能用,最后还是得研究redmine的官方主页才行。
redmine官方主页是:http://www.redmine.org
关于邮件配置的是 http://www.redmine.org/projects/redmine/wiki/EmailConfiguration
1、需SMTP登陆验证的电子邮件配置,关键是配置configuration.yml文件。不仅要配置默认的email_delivery,还要配置production和development段才行。
# Outgoing email settings
production:
delivery_method: :smtp
smtp_settings:
address: smtp.zzz.com
port: 25
domain: smtp.zzz.com
authentication: :login
user_name: myname
password: mypass
development:
delivery_method: :smtp
smtp_settings:
address: smtp.zzz.com
port: 25
domain: smtp.zzz.com
authentication: :login
user_name: myname
password: mypass
2、如果你想使用TLS-requiring SMTP servers,必须设置TLS-related settings
production:
delivery_method: :smtp
smtp_settings:
tls: true
enable_starttls_auto: true
address: "smtp.gmail.com"
port: '587'
domain: "smtp.gmail.com"
authentication: :plain
user_name: "your_email@gmail.com"
password: "your_password"
3、不需要登陆验证的设置
production:
delivery_method: :smtp
smtp_settings:
address: smtp.knology.net
port: 25
domain: cybersprocket.com
authentication: :none
测试是否配置成功:
打开Redmine >管理员登陆 > 管理 > 配置 > 邮件通知 >页面底部:发送测试邮件。将会发送邮件到你目前登陆的用户邮箱中。
您还可以在这个页面中进行邮件内容的配置,包括邮件头,邮件签名等。
您还可以在这个页面中选择需要发送邮件通知的动作。
按照上面的方式,总算大功告成了。