在 Redmine 中整合 Git 版本库
- 本站文章除注明转载外，均为本站原创或者翻译。
- 本站文章欢迎各种形式的转载，但请18岁以上的转载者注明文章出处，尊重我的劳动，也尊重你的智商；
- 本站部分原创和翻译文章提供markdown格式源码，欢迎使用 文章源码 进行转载；
- 本博客采用WPCMD 维护；
- 本文标题：在 Redmine 中整合 Git 版本库
- 本文链接： http://zengrong.net/post/2606.htm
Redmine 的官方 Wiki 里面有许多文档可能过时了，可能并非 Best Practice 。关于如何在 Redmine 中整合 Git 版本库， 这篇文章 是最简单的。我把原文做了一些修改，使用中文提供在这里：
- 第一步： Clone 版本库
- 第二步： 配置 Redmine
- 第三步：定时刷新版本库
- 设置默认显示的版本库分支
- 我的 redmine 用户名称为： redmine ；
-
我的安装目录在
/srv/redemine，我的仓库文件夹为/srv/redmine/repos； -
git 的仓库的地址为
ssh://redmine@git.mysite.com:29418/a.git和ssh://redmine@git.mysite.com:29418/b.git（是的，我使用 Gerrit）。
Redmine 使用的方法，就是从远程版本库中 Clone 一个版本库，然后把所有的提交信息写入 Redmine 的数据库中。
第一步： Clone 版本库
首先使用 MIRROR 模式来 Clone 我们的版本库。Mirror 模式的版本库将仅包含提交信息而不包含具体提交的文件。这会让我们 Clone 的内容比较小，速度足够快。
sudo -su redmine cd /srv/redmine/repos/ git clone --mirror ssh://redmine@git.mysite.com:29418/a.git git clone --mirror ssh://redmine@git.mysite.com:29418/b.git
接下来需要让 Redmine 中配置版本库的路径。
第二步： 配置 Redmine
进入 “administration > project -> repositories” 界面开启版本库支持。然后进入 “project -> settings -> repositories” 增加版本库配置：
- Type: GIT
- Main-repository: 是否是主版本库。主版本库只能有一个。
- Name: 一般是使用和版本库相同的名称。
-
Path: 版本库在服务器上的绝对路径。
/srv/redmine/repos/a.git
版本库可以增加多个，可以再加入一个版本库指向 b.git
。但是主版本库只能有一个，如果两个都设置成了主版本库，那么生效的是最新的那一个。
配置完成后，进入项目的版本库界面就能看到版本库的提交历史记录和版本树了。
如果你的版本库有成百上千次提交，那么第一次打开版本库界面可能会等上一段时间，因为 Redmine 在把版本库中的提交信息写入数据库。此时最好不要刷新界面。
为了避免上面的情况，可以做离线刷新： Attaching an existing repository to a project 。
第三步：定时刷新版本库
Redmine 并不会主动去刷新版本库。我们可以使用 GitHook 的方式来更新版本库，也可以直接用 Crontab 来实现。
下面的代码设定每隔 5 分钟去远程仓库同步一次。
sudo crontab -e -u redmine # 如果当前处于 redmine 账户下，也可以使用 crontab -e # 选择你喜欢的编辑器，在打开的编辑器中写入下面的内容 */5 * * * * git -C /srv/redmine/repos/a fetch --all */5 * * * * git -C /srv/redmine/repos/b fetch --all
设置默认显示的版本库分支
Redmine 默认显示的提交信息是仓库的默认分值（一般为 master 分支）。如果你使用了 git flow 工作流
，那么很可能你会希望默认分支是 develop
。
这就出现了新问题：在使用 --mirror
参数 clone 的仓库中，你不能使用 git checkout develop
来切换工作分值。
此时你可以使用下面的命令来切换默认分支：
git symbolic-ref HEAD refs/heads/develop
symbolic-ref 子命令的说明在此： git-symbolic-ref 。
当然，你也可以直接编辑 /srv/redmine/repos/a.git/HEAD
这个文件，能达到一样的效果。
在提交信息中更新问题
在管理员面板中将版本库的 Referencing keywords 设置为： issue；将 Fixing keywords 的值设置为： fix 。
在提交信息中使用下面的语法来引用问题1，2，同时把问题3置为 已解决 状态：
这个问题 issue #1, #2 和 fix #3 这个问题 issue:#1, #2 和 fix:#3 这个问题 issue: #1, #2 和 fix: #3
更详细的内容可以参考： Referencing issues in commit messages 。
（全文完）
正文到此结束
热门推荐
相关文章
近期评论
-
文章和留言都翻到11页了 没有OOM
-
-
朋友，翻页到11页，及以后，会出现OOM，无法访问
-
-
搞个gitee的项目
-
-
版本号是多少，你可以下载哪个代码仓库，jdk选1.8 直接跑就行
-
-
-
Loading...
![[HBLOG]公众号](https://www.liuhaihua.cn/img/qrcode_gzh.jpg)
