redmine配置及邮件发送

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段才行。

default:
  # Outgoing emails configuration (see examples above)
  email_delivery:
    delivery_method: :smtp
  smtp_settings:
    address: smtp.zzz.com
    port:25
    domain: smtp.zzz.com
    authentication: :login
    user_name: myname
    password: mypass

# 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 >管理员登陆 > 管理 > 配置 > 邮件通知 >页面底部:发送测试邮件。将会发送邮件到你目前登陆的用户邮箱中。

您还可以在这个页面中进行邮件内容的配置，包括邮件头，邮件签名等。

您还可以在这个页面中选择需要发送邮件通知的动作。

按照上面的方式，总算大功告成了。