使用Gitolite搭建Git服务器

Git服务的管理工具，主要有如下几种。

Gitolite 使用perl语言编写，维护和更新比较积极，下面测试使用Gitolite搭建Git服务器。

一般新建用户 ~/.ssh/ 目录是不存在的。

生成路径会在ssh-kengen执行后给出，也可修改。windows下生成路径默认位于 C:/user/用户名/.ssh 下。

此时， gitolite 会初始化两个仓库，同时创建 authorized_keys 文件

管理库中有两个目录， conf/ 和 keydir/ 。

仓库的创建通过编辑 gitolite-admin/conf/gitolite.conf 即可，然后将配置后的文件上传服务器。

若本地已有仓库repo2，将其添加到服务器

gitolite可以通过用户组的方式进行管理

如上提示，需要输入密码。

需要安装 openssh ，并将 gitolite 用户添加在 sshusers 组中，有的服务器可能是 ssh 组。

计算机领域的Cookbook指的是实用经典案例的意思，是对一些普遍性问题的解决方案的总结和整理。

首先要有 ssh远程登陆的工具，比如secureCRT等

方案一 基于SSH直接搭建

Git支持的协议主要是四种：

本地: 需要文件共享系统，权限不好控制

HTTP：速度慢

SSH：同时支持读写操作，不支持匿名的读取(Git默认协议)

GIT：最快

从搭建的难易程度和特点综合筛选，最合适的还是ssh，并且大部分服务器上基本都有ssh服务，所以省去了不少麻烦。一个最基本的思路是给每一个人一个ssh帐号，这样大家就可以通过用户名和口令来访问了，但是显然这不是一个好的选择，这个做法有些多余，并且对于repo的权限很难管理。

在使用Github的时候，会利用rsa.pub公钥/私钥的方式，这样在服务端拥有用户的公钥（*.pub）之后就可以，跨过繁琐的口令，直接认证提交了，而服务端也会根据不同的用户身份，对其权限有着更加灵活的管理。因此我们也采用这种方式。

服务端

为了使远程库访问更加直观，先在服务器上创建一个名为git的账户，这样以后clone的时候就如下面的格式了：

git clone git@server:some.git

创建新的用户，创建repo等目录

$sudo adduser git

$su git

$cd ~

$mkdir repos

在HOME下的.ssh目录，如果没有则创建，创建一个authorized_keys文件，这个文件就是用来管理所有git用户的公钥的，也就是这里面的用户对于项目有着R+W的权限。

客户端

对于每一个客户端，我们需要生成一对密钥和公钥，如果是Github用户，那么.ssh目录下，一定有id_rsa.pub和id_rsa两个文件，其中第一个是系统生成的公钥，另一个是自己要保存好的密钥。如果没有的话，可以在终端执行：ssh-keygen来生成，完成后，将自己的公钥提交给管理员，这就是一个注册的行为。

完成

最后一步，管理员将团队成员的公钥添加到authorized_keys中，比如将同学susie加入：

$ cat susie.pub >>authorized_keys

至此，大家可以通过git@server:repos/some.git来访问公共的版本库了。

问题

安全问题，成员可以登录git用户的shell,细节权限如分支等不好控制

管理麻烦，新建repo,或者增加成员比较麻烦，尤其是修改的时候

方案二 使用Gitolite服务

Gitolite 也是基于SSH协议构建的方便管理git repo的应用，可以通过其源码安装.

安装

安装按照官方给定的文档就可以轻易的实现：

$ git clone git://github.com/sitaramc/gitolite

$ mkdir -p $HOME/bin

$ gitolite/install -to $HOME/bin

$ gitolite setup -pk YourName.pub

如果执行最后一条命令的时候，gitolite不识别，则可以通过下面两种方式解决：

将gitolite添加到PATH里面

通过$HOME/bin/gitolite setup -pk YourName.pub 执行

至此，gitolite在服务端，搭建完毕，会发现此时HOME目录下增加了一个文件projects.list和一个目录repositories,后者就是我们的版本仓库了，每当新建repo的时候，就会在其中创建。

使用

是时候说一下gitolite的管理模式了，他会创建一个gitolite-admin的repo，管理员就是通过像这个repo提交配置文件而实现对git服务器的控制的。

首先，将这个repo导入到我们的workspace：在此之前，需要配置本地的ssh,gitolite要求管理员的本地密钥和其注册公钥的名字一致，比如我们安装的时候指定 -pk后面为 admin.pub 则管理员本地需要由admin对应的私钥。我们可以通过~/.ssh/config来进行配置（注：有些系统可以用conf，Mac OSX 下无效，只能用config).

host gitolite

user git

hostname yourhostname.com

port 22

identityfile ~/.ssh/admin

这样，当我们访问gitolite的时候就会自动根据配置文件执行，配置完成后可以根据下面的命令，将gitolite-admin转移到本地。

git clone gitolite:gitolite-admin.git

克隆完成后，可以发现，gitolite-admin下面有两个目录，其中conf保存配置文件，我们可以通过编辑里面的gitolite.conf文件，管理git服务器，keydir目录保存用户的公钥pub文件。

当我们讲修改后的repo 提交的时候，gitolite就会自动的应用这些配置，管理过程就方便了很多。

配置规则

打开gitolite.conf文件可以看到其中的示例：

To add new users alice, bob, and carol, obtain their public keys and add them to 'keydir' as alice.pub, bob.pub, and carol.pub respectively.

To add a new repo 'foo' and give different levels of access to these users, edit the file 'conf/gitolite.conf' and add lines like this:

repo foo

RW+ = alice

RW = bob

R = carol

上面的配置文件就是新建了一个repo foo，并且添加了三位项目成员，每一个人的权限不同。提交push后，管理便生效了。

可视化

我们可能会需要一个web界面来管理这些项目，我目前知道的有三种方式：

git源码中自带的组件，cgi脚本实现，使用gitolite服务

gitlab开源框架，基于ROR，新版本不再使用gitolite服务

FB开源PHP框架 phabricator，功能高端上档次

OS：CentOS 7.2

Git：1.8.3.1

备份模式：

以下步骤以双机备份为例，单机备份同理，只是在镜像git项目的时候把git url换成单机中的git项目目录即可。

首先，查看系统软件库中是否有git和git的版本：

CentOS 7.2环境下的输出如下：

CentOS 7.x版本的仓库中已经附带了1.8.3.1版本的git，可以直接安装。

CentOS 6.x中的git是1.7.x版本，自带库中git版本低的linux发行版可以添加git1.8.3.1的源来安装git，但这个操作要求本机能访问互联网

其他版本的git理论上也可以，请自行测试

结果最后显示“安装完成”或“Complete”表示安装成功。可以直接使用git命令测试一下：

输出如下表示git安装成功并可用。

创建一个git用户，用来提供给外部用户以git url的方式访问git库。

在用户目录或其他对外目录中创建 /git/repos 目录，用来存放git库。

注意： 尽量使用git用户来创建该目录，方便以后git操作该目录，如果是使用其他用户创建的，记得使用以下命令将该目录的owner改为git：

为了方便访问，可以在根目录下创建一个软链连接到该目录：

这样设置后，假如以后有一个库叫 test.git ，那么就可以通过以下url来访问git库了：

创建一个测试库用来测试备份及连通性。

同主GIT服务器的《安装git》章节。

同主GIT服务器的《创建git库目录》章节。

目录结构尽量与主git服务器上的结构一致，如果不一致，使用软链的形式将git url配置为与主git服务器一致，这样保证在切换服务器时，客户端不用做修改操作。

以上个步骤中创建的 test.git 为例：

这样，主git服务器中的 test.git 就镜像到备份机中了。

如果主服务器的git项目发生了变更，可以将变更同步到备份机。

将以上同步命令写成脚本，添加一个定时任务来定时同步即可。

（待补充）

备份同步时每次都需要输入主git服务器的密码，比较麻烦，也不利于定时同步的脚本操作，可以使用ssh免密登录的方式，在主服务器上配置备份服务器的公钥。

一路Enter（回车键），完成后会打印出密钥的生成位置，通常在用户主目录的 .ssh 目录中。默认情况下会生成以下两个文件：

一定要注意上述命令中的第三步，权限要设置对，否则认证不过去不能免密登录。

如果在实际运行中，主git服务器挂了一段时间，在这段时间里一直是备份git服务器在工作，那么在修复好主服务器后需要将这一段时间的变更同步回主服务器。

操作完成后备份库自上一次同步后的更改都推送到了主库。

---