（步骤 1）安装依赖项

在更新插件之前，不要忘记备份数据库并停止 Redmine！

# Install dependencies (On Debian/Ubuntu)
root# apt-get install build-essential libssh2-1 libssh2-1-dev cmake libgpg-error-dev

# Install dependencies (On Fedora/CentoS/RedHat)
root# yum groupinstall "Development Tools"
root# yum install libssh2 libssh2-devel cmake libgpg-error-devel

如果您正在使用 Bitnami Redmine Stack，则必须在执行任何安装准备之前运行此程序：Bitnami 安装。

（步骤 2）克隆插件

假设您已经安装了Redmine：

# Switch user
root# su - redmine

# First git clone Additionals
redmine$ cd REDMINE_ROOT/plugins
redmine$ git clone --branch 3.0.6 https://github.com/AlphaNodes/additionals.git

# Then Redmine Git Hosting plugin
redmine$ cd REDMINE_ROOT/plugins
redmine$ git clone https://github.com/jbox-web/redmine_git_hosting.git
# last release version is broken, use master branch till next version released!
# redmine$ cd redmine_git_hosting/
# redmine$ git checkout 6.0.0

# Install gems and migrate database
redmine$ cd REDMINE_ROOT
redmine$ bundle config set --local without 'development:test'
redmine$ bundle config set --local build.rugged --with-ssh
redmine$ bundle install
redmine$ bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=additionals
redmine$ bundle exec rake redmine:plugins:migrate RAILS_ENV=production NAME=redmine_git_hosting

否则，您可以按照 wiki 安装 Redmine：如何安装 Redmine。

如果bundle命令在 Bitnami Stack 上抱怨，请查看这个。

（步骤 3）为运行 Redmine 的用户创建 SSH 密钥

由于我们需要在非交互模式下通过 SSH 发送命令，因此 SSH 密钥不能包含密码（-N ''参数）。此外，最好将 SSH 密钥存储在 REDMINE_ROOT 路径之外，以便

root$ su - redmine
redmine$ mkdir ssh_keys
redmine$ ssh-keygen -m PEM -N '' -f ssh_keys/redmine_gitolite_admin_id_rsa

在 Bitnami 堆栈上：

bitnami$ cd /opt/bitnami/apps/redmine/
bitnami$ mkdir ssh_keys
bitnami$ chgrp daemon ssh_keys
bitnami$ ssh-keygen -m PEM -N '' -f ssh_keys/redmine_gitolite_admin_id_rsa
bitnami$ chmod 640 ssh_keys/*

如果您使用 Apache 运行 Redmine：

root# sudo -u www-data  mkdir -p            /var/www/redmine/ssh_keys
root# sudo -u www-data  ssh-keygen -m PEM -N '' -f /var/www/redmine/ssh_keys/redmine_gitolite_admin_id_rsa

确保 SSH 公钥是使用密钥格式 PEM 创建的（使用ssh-keygen 的-m PEM 参数）。

您必须配置插件以指向该路径。

（步骤 4）运行 Redmine 的用户必须具有gitolite-admin 的RW+访问权限

假设您已经安装了 Gitolite，请在gitolite.conf文件中添加以下内容：

repo    gitolite-admin
  RW+                            = redmine_gitolite_admin_id_rsa

否则，您可以按照以下步骤安装 Gitolite (v3)（这将自动设置上面的行）：

Server requirements:

  * any unix system
  * sh
  * git 1.6.6+
  * perl 5.8.8+
  * openssh 5.0+
  * a dedicated userid to host the repos (in this document, we assume it
    is 'git'), with shell access ONLY by 'su - git' from some other userid
    on the same server.

Steps to install:

  * login as 'git' as described above

  * make sure ~/.ssh non-existent

  * make sure **Redmine SSH public key** we've just created (step 3) is available at $HOME/redmine_gitolite_admin_id_rsa.pub

  * add this in ~/.profile

        # set PATH so it includes user private bin if it exists
        if [ -d "$HOME/bin" ] ; then
          PATH="$PATH:$HOME/bin"
        fi

  * run the following commands:

        root$ su - git
        git$ mkdir $HOME/bin
        git$ source $HOME/.profile
        git$ git clone git://github.com/sitaramc/gitolite
        git$ gitolite/install -to $HOME/bin
        git$ gitolite setup -pk redmine_gitolite_admin_id_rsa.pub

（步骤 5） Gitolite 必须接受钩键

root$ su - git
git$ vi (or nano) .gitolite.rc

## Look for GIT_CONFIG_KEYS and make it look like :
GIT_CONFIG_KEYS  =>  '.*',

## Enable local code directory
LOCAL_CODE       =>  "$ENV{HOME}/local"

## then save and exit

（步骤 6）配置 sudo

以 root 身份创建文件/etc/sudoers.d/redmine并将以下内容放入其中：

Defaults:redmine !requiretty
redmine ALL=(git) NOPASSWD:ALL

然后对文件进行 chmod 操作：

root# chmod 440 /etc/sudoers.d/redmine

（步骤 7）在 known_hosts 列表中添加 Gitolite 服务器

确保 Redmine 用户的 known_hosts 列表中有 Gitolite 服务器。这也是检查 Gitolite 是否正常工作的好方法。

它不应该要求您输入密码。

另外，Redmine 用户的 SSH 配置文件 ( <redmine user home>/.ssh/config) 也不再需要了！如果存在，请删除！

root$ su - redmine
redmine$ ssh -i ssh_keys/redmine_gitolite_admin_id_rsa git@localhost info
# accept key

你应该得到类似这样的结果：

hello redmine_gitolite_admin_id_rsa, this is gitolite v2.3.1-0-g912a8bd-dt running on git 1.7.2.5
the gitolite config gives you the following access:
    R   W  gitolite-admin
    @R_ @W_ testing

或者

hello redmine_gitolite_admin_id_rsa, this is git@dev running gitolite3 v3.3-11-ga1aba93 on git 1.7.2.5
    R W  gitolite-admin
    R W  testing

如果您收到其中一条消息，则说明您走对了路 ;)

（步骤 8）为 post-receive hook 安装 Ruby 解释器

我们的 post-receive 钩子在每次提交后触发，用于在 Redmine 中获取变更集。由于它是用 Ruby 编写的，因此您需要在服务器上安装 Ruby。请注意，这与 RVM 不冲突。这些钩子至少需要Ruby 2.5 版本。

root$ apt-get install ruby
# or
root$ yum install ruby

（步骤 9）完成安装 - 配置

插件现已安装，您可以重新启动Redmine:)

但您必须设置一些额外的设置：

在管理 -> 设置 -> 存储库中启用 Xitolite 存储库

1. 在管理 -> Redmine Git Hosting中配置插件设置，具体如下：
   • SSH 密钥路径
   • 临时目录路径（用于存储 GitoliteAdmin 存储库）
   • 访问 URL（SSH、HTTP、HTTPS）
   • 钩子 url（此 url 将由我们的 Gitolite 钩子调用以触发存储库视图刷新，因此请确保它是可调用的）
   • 安装钩子（这可能会覆盖您现有的 Gitolite 钩子）

在管理 -> Redmine Git 托管 配置检查选项卡中检查您的安装。

1. 在管理 -> 角色页面上设置一些权限，特别是如果您希望用户能够创建 SSH 密钥（见下文）。

在配置插件之前，您应该看一下这个：存储库存储配置策略。

如果您再次使用 Bitnami Stack：您必须正确配置临时目录。操作方法如下。

更改设置后，您可能需要重新启动 Redmine，因为其中一些设置会被放入缓存中。

（步骤 10）添加您的 SSH 密钥

存储库访问基于 Redmine 项目的成员资格和成员的角色：您必须添加具有足够角色的用户作为项目成员才能克隆/更新存储库。

您还需要在管理 -> 角色页面配置角色的权限。

除非您想通过智能 HTTP 专门访问您的存储库，否则用户将需要设置公钥才能通过 SSH 连接。

为此，打开浏览器，登录 Redmine，然后点击页面右上角的“我的帐户”链接，然后点击“添加 SSH 密钥”链接。

SSH 密钥应该是唯一的，也就是说，您在 Redmine 中设置的密钥不应该已经存在于 Gitolite 仓库中。

特别是，不要重复使用您设置为 Gitolite 管理密钥的密钥。

此时，插件应该可以正常工作了。