Redmine和Gitlab的集成和联动
本文的操作将达成如下目的： 1、在 Redmine 中查看 GitLab 仓库中的变更。 2、Redmine 中更新 Gitlab 仓库。 3、利用 Git Commit Log 改变 Redmine 中的 Issue 状态。 工作环境 该过程在 Kubernetes 环境中完成。 Redmine：sameersbn/redmine:3.3.1 Gitlab：官方镜像 Redmine 设置 系统仓库设置 以管理员身份登入 Redmine，进入 Administration -> Repositories （ settings?tab=repositories ）。 SCM · Enabled SCM 中，我们要使用的 Gitlab，因此需要启用 Git 。如果 Git 不可选，则需要确认是否安装了 git，并在 Redmine 的 configuuration.yml 中进行设置。 · Fetch commits automatically：True，这个选项只是在用户打开仓库页面时候会获取仓库内容，别想多了。 · Enable WS for repository management：True · Repository management WS API key：这里需要生成一个 API Key，用于后面的 WebHook 触发。 Commit 信息设置 · Referencing keywords：引用关键字，保持缺省即可，在 Commit 信息中加入 refs #1 ，信息中会有到 #1 Issue 的连接。 · 下面的表格中可以根据 Commit log 中的关键字对 Issue 进行更新（状态和进度），例如填写 fixed fixed %60 的话，代表 Commit 信息中如果出现 fixed #1 ，则会把 Issue #1 更新为 Fixed，进度推进到 60%。 为项目获取 Git 仓库 在 Redmine 能访问得到的路径中，使用 git 命令克隆仓库： git clone --mirror git@github.com:git_user/project.git 项目仓库设置 · 进入项目的仓库设置页面（ projects/[project-id]/settings/repositories ） · 添加仓库 · 路径指向上个步骤中的本地仓库的位置。 · 保存。 · 在 projects/[project-id]/repository 中，现在可以看到版本库和文件了，并可以进行 diff 等操作。 安装插件 接下来安装 Redmin 插件 该插件将在 Redmine 中运行，用来响应来自 Gitlab 的 Webhook Post 请求。 Github： https://github.com/phlegx/redmine_gitlab_hook 下载到 Redmine 的插件目录之后，重启 Redmine 即完成安装。 可以在 Redmine 的 admin/plugins 中看到这一新安装的插件。 进入 settings/plugin/redmine_gitlab_hook ，选中 All branches 。 Gitlab 设置 Gitlab 的设置分两步，第一是将 Issue 管理功能从内置模块转为使用 Redmine，第二是利用 Webhook 在发生事件的时候，引发 Redmine 的仓库更新。 Issue 进入 Gitlab 的项目服务设置页面： [project-url]/services ，找到 redmine 的设置： · Active：True · Trigger：Push · Project url：Redmine 中相关的项目地址，例如 http://redmine.local/projects/sample-project · Issues url：一般是 Project url + issues ，例如 http://redmine.local/projects/sample-project/issues · New issue url：通常是 Issues url + new ，例如 http://redmine.local/projects/sample-project/issues/new 保存退出后，该项目的 Issue 相关连接会转向 Redmine 中。（挺 Low 的。。） Webhook Webhook 是 Gitlab 的事件触发系统，这里我们借助这一功能，同 Redmine 的 Gitlab 插件协作，触发 Redmine 的自动更新。 浏览项目的 Webhook 页面： [project-url]/hooks ，新建一个，URL 栏目填写 http://redmine-url/gitlab_hook?project_id=[project-id]&key=[repository-token] ，key 部分是前文中提到的 Repository Token。 测试 Git clone 代码之后，进行修改，提交 Comment 中写入 fixed #1，看 Redmine 中的这一 Issue 是否发生更新。
