本文的操作将达成如下目的:
  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 是否发生更新。