范围
本文将展示如何将GIT存储库集成到redmine项目以及如何使存储库保持最新。
先决条件
- redmine-directory的所有者需要SSH-Key和(读取)访问要集成在redmine中的存储库。
- 需要一个克隆GIT存储库的目录。
- Redmine必须找到GIT二进制文件,这意味着必须安装GIT。 您可以在redmine中的“管理>存储库”设置中进行检查。 如果有绿色选中标记,一切都很好。 如果不是,您必须先安装GIT,例如 通过“apt-get install”
配置示例
为了更好地理解这个HowTo,我将使用以下配置
- 我的redmine被称为“redmine”
- 我的redmine主目录是“/ var / lib / redmine”,我将在那里创建一个子目录“repos”,在那里我克隆了存储库。 所以这个目录的完整路径是“/ var / lib / redmine / repos /”
- 我的repo的URL是“git.my-url.com”,名称是“my_repo”,所以完整的URL是“git@git.my-url.com:my_repo”
第1步:克隆存储库
首先,我们需要将存储库克隆为MIRROR(而不是BARE!)存储库。 镜像存储库没有工作文件,只有提交信息,我们需要redmine。
我们切换到redmine-user并将存储库克隆到选择的目录中。
$ sudo -su redmine
$ cd / var / lib / redmine / repos /
$ git clone --mirror git@git.my-url.com:my_repo my_repo
现在所有存储库信息都在磁盘上,但redmine对此一无所知。 所以在下一步我们将改变这一点。
第2步:介绍存储库以进行redmine
在redmine中,我们打开“管理>项目 - >存储库”对话框。您也可以通过“项目 - >设置 - >存储库”访问此对话框。我们添加了一个新的存储库
Type: GIT
Main-repository: check this if the cloned repository is you main repository, if not leave it unchecked.
Name (redmine intern): I suggest to choose the same name as the repository, e.g. "my_repo"
Path: Absolute path of the repository, e.g. "/var/lib/redmine/repos/my_repo"
现在redmine知道存储库。如果在项目中打开“repository”-tab,您将看到存储库树,最后提交等等。
注意:当您打开对话框时,redmine会从上次任何人打开此对话框时获取本地存储库和redmine数据库的所有更改集。特别是第一次打开大型存储库对话框可能需要很长时间。不要取消进度,只需让redmine工作直到完成。可能的谬误:当打开对话框时,redmine不会从GIT中获取新的提交!这意味着如果不更新本地GIT存储库,您将永远不会在redmine中看到新的提交。为此,我们将在第3步中编写一个自动任务。
第3步:添加cronjob以获取GIT存储库
为了使GIT存储库自动更新,我们将添加一个cronjob。
我们为用户“redmine”打开用户指定的crontab,并添加一个cronjob以每五分钟获取一次所有分支。
$ sudo crontab -e -u redmine
* / 5 * * * * cd / var / lib / redmine / repos / my_repo && git remote update
或者我们可以直接编辑“/ etc / crontab”文件。 如果我们这样做,我们必须添加应该执行命令的存储库所有者的用户名。
$ nano / etc / crontab
* / 5 * * * * redmine cd / var / lib / redmine / repos / my_repo && git fetch --all
注意如果克隆多个存储库,则必须为每个存储库添加crontab行。
网友评论