如何轻松地将GIT版本库集成到redmine中

范围

本文将展示如何将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行。