如何将gitosis 安装之前的git库纳入管理

1. 安装git

emerge -av dev-util/git

2.安装gitosis

git环境默认是可以直接使用的,但需要为每个成员开ssh权限帐号,且各个仓库之间的交叉权限管理很麻烦，所以需要使用gitosis, 它无需为每个开发人员开设ssh帐号，安全方便。

emerge -av gitosis

如果提示这个包被mask了，需要编辑/etc/portage/package.keywords文件，在里面加入

dev-util/gitosis ~amd64

3.生成公钥

在客户端使用

ssh-keygen -t rsa

来生成ssh的key，注意你的主机名需要是全部英文字符，不能有下划线或者.之类的特殊字符，否则后面在服务端生成版本库的时候会报错。

4.上传公钥

从客户端把刚刚生成的公钥上传到服务器上。

scp ~/.ssh/id_rsa.pub USER@YOUR_SERVER:/tmp

5.在服务端生成管理库

sudo -H -u git gitosis-init </tmp/id_rsa.pub

成功的话，你将看到类似下面的提示：

Initialized empty Git repository in /var/spool/gitosis/repositories/gitosis-admin.git/

Reinitialized existing Git repository in /var/spool/gitosis/repositories/gitosis-admin.git/

设置post-update脚本权限

chmod 755 /var/spool/gitosis/repositories/gitosis-admin.git/hooks/post-update

至此，服务端配置已经完成。

6.同步配置文件

gitosis本身就是一个git库，所以管理起来非常方便。下面在客户端同步gitosis管理库

git clone git@YOUR_SERVER:gitosis-admin.git

cd gitosis-admin

你将看到以下文件

-rw-r--r-- 1 garry garry 104 Nov 13 05:43 gitosis.conf

drwxr-xr-x 3 garry garry 102 Nov 13 05:43 keydir/

gitosis.conf是gitosis的配置文件，用于配置用户和权限

keydir/是所有组成员的公钥

我们可以在本地修改配置更改权限，然后push到服务端后，服务器端就立刻生效

7.创建新的repositories

打开gitosis.conf文件，你将看到

[group gitosis-admin]

writable = gitosis-admin

members = elton@macbook

这个是管理组的权限，members中的用户名就是刚才上传的公钥里面的用户名。

在这个文件后面加入:

[group myteam]

members = elton@macbook

writable = free_monkey

这里你定义了一个叫myteam的组，授予elton@macbook这个用户写“free_monkey”这个repo的权限

git commit -a -m "Allow elton write access to free_monkey"

git push

上面的 *** 作就更新了服务端的权限。

下面就开始创建free_monkey的repo

mkdir free_monkey

cd free_monkey

git init

创建 .gitignore 文件，用于忽略某些不需要进行代码管理的内容，如rails的应用可能如下：

.DS_Store

log/*.log

tmp/**/*

config/database.yml

db/*.sqlite3

提交代码：

git remote add origin git@YOUR_SERVER_HOSTNAME:free_monkey.git

git add .

git commit -a -m "initial import"

git push origin master:refs/heads/master

接下来，可以增加成员的公钥到系统中了

cd gitosis-admin

cp ~/alice.pub keydir/

cp ~/bob.pub keydir/

git add keydir/alice.pub keydir/bob.pub

修改gitosis.conf

[group myteam]

- members = jdoe

+ members = jdoe alice bob

writable = free_monkey

提交修改：

git commit -a -m "Granted Alice and Bob commit rights to FreeMonkey"

git push

其它成员就可以获取代码了

git clone git@YOUR_SERVER:free_monkey.git

1. 架设Git服务器

我们以Ubuntu为例。首先，在git服务器上创建一个名为 'git' 的用户，并为其创建一个.ssh 目录。并将其权限设置为仅git用户有读写权限

$ sudo adduser git

$ su git

$ cd

$ mkdir .ssh

$ chmod 700 .ssh

接下来，把开发者的 SSH 公钥添加到这个用户的 authorized_keys 文件中。假设你通过电邮收到了几个公钥并存到了临时文件里。重复一下，公钥大致看起来是这个样子：

$ cat /tmp/id_rsa.john.pub

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQCB007n/ww+ouN4gSLKssMxXnBOvf9LGt4L

ojG6rs6hPB09j9R/T17/x4lhJA0F3FR1rP6kYBRsWj2aThGw6HXLm9/5zytK6Ztg3RPKK+4k

Yjh6541NYsnEAZuXz0jTTyAUfrtU3Z5E003C4oxOj6H0rfIF1kKI9MAQLMdpGW1GYEIgS9Ez

Sdfd8AcCIicTDWbqLAcU4UpkaX8KyGlLwsNuuGztobF8m72ALC/nLF6JLtPofwFBlgc+myiv

O7TCUSBdLQlgMVOFq1I2uPWQOkOWQAHukEOmfjy2jctxSDBQ220ymjaNsHT4kgtZg2AYYgPq

dAv8JggJICUvax2T9va5 gsg-keypair

只要把它们逐个追加到 authorized_keys 文件尾部即可，同时将authorized_keys设置为仅git用户有读写权限。

$ cat /tmp/id_rsa.john.pub >>~/.ssh/authorized_keys

$ cat /tmp/id_rsa.josie.pub >>~/.ssh/authorized_keys

$ cat /tmp/id_rsa.jessica.pub >>~/.ssh/authorized_keys

$ chmod 600 ~/.ssh/authorized_keys

现在可以用 --bare 选项运行 git init 来建立一个裸仓库，这会初始化一个不包含工作目录的仓库。

$ cd /opt/git

$ mkdir project.git

$ cd project.git

$ git --bare init

这时，Join，Josie 或者 Jessica 就可以把它加为远程仓库，推送一个分支，从而把第一个版本的项目文件上传到仓库里了。值得注意的是，每次添加一个新项目都需要通过 shell 登入主机并创建一个裸仓库目录。我们不妨以 gitserver 作为 git 用户及项目仓库所在的主机名。如果在网络内部运行该主机，并在 DNS 中设定 gitserver 指向该主机，那么以下这些命令都是可用的：

# 在 John 的电脑上

$ cd myproject

$ git init

$ git add .

$ git commit -m 'initial commit'

$ git remote add origin git@gitserver:/opt/git/project.git

$ git push origin master

这样，其他人的克隆和推送也一样变得很简单：

$ git clone git@gitserver:/opt/git/project.git

$ vim README

$ git commit -am 'fix for the README file'

$ git push origin master

用这个方法可以很快捷地为少数几个开发者架设一个可读写的 Git 服务。

作为一个额外的防范措施，你可以用 Git 自带的 git-shell 工具限制 git 用户的活动范围。只要把它设为 git 用户登入的 shell，那么该用户就无法使用普通的 bash 或者 csh 什么的 shell 程序。编辑/etc/passwd 文件：

$ sudo vim /etc/passwd

在文件末尾，你应该能找到类似这样的行：

git:x:1000:1000::/home/git:/bin/sh

把 bin/sh 改为 /usr/bin/git-shell （或者用 which git-shell 查看它的实际安装路径）。该行修改后的样子如下：

git:x:1000:1000::/home/git:/usr/bin/git-shell

现在 git 用户只能用 SSH 连接来推送和获取 Git 仓库，而不能直接使用主机 shell。尝试普通 SSH 登录的话，会看到下面这样的拒绝信息：

$ ssh git@gitserver

fatal: What do you think I am? A shell?

Connection to gitserver closed.

这里提供的方法，组内所有成员对project都有读写权限，也就是说每个分支都可以push代码，如果需要更加细致的权限控制，请使用Gitosis或者Gitolite。

2. 搭建Gitweb

安装gitweb之后就可以通过网站访问我们的项目了。就像一样显示了

首先需要安装Gitweb，如果没有安装apache，那么直接安装Gitweb，也会将apache2安装的。

$ sudo apt-get install gitweb apache2

安装完成之后，我们只需要修改一下配置文件，将/etc/gitweb.conf文件中的$projectroot修改为放工程文件的目录。

$ vim /etc/gitweb.conf

# path to git projects (<project>.git)

$projectroot = "/opt/git"

至此gitweb就可以使用了，现在可以通过http://[git_server_IP]/gitweb访问了。

3. Push之后发送邮件通知

当组内成员push代码到服务器上之后，会自动发送邮件通知组内所有人员，该次push的具体内容是什么。具体配置方法：

一般在安装Git的时候发送邮件的脚本/usr/share/git-core/contrib/hooks/post-receive-email已经存在了，首先要修改所有者和执行权限，并且安装sendmail。

$ sudo chown git:git post-receive-email

$ sudo chmod 755 post-receive-email

$ sudo apt-get install sendmail

然后到切换到工程目录下的hooks中，添加 post-receive软链接指向 /usr/share/git-core/contrib/hooks/ post-receive-email。

$ cd /opt/git/project.git/hooks

$ ln -s /usr/share/git-core/contrib/hooks/post-receive-email post-receive

最后修改工程目录中的config文件即可。mailinglist是邮件列表， envelopesender是发件人的邮箱，

$ vim /opt/git/project.git/config

[core]

repositoryformatversion = 0

filemode = true

bare = true

[hooks]

mailinglist = "example@gmail.com, example2@gmail.com" # 收件人列表

envelopesender = project.git@example.com # 送件人地址

emailprefix = "[Project commit] " # 邮件标题前缀

showrev = "git show -C %secho"# 不只显示有变化的文件，同时也显示改变的内容

为了使邮件显示的更清楚，还要修改一下工程目录当中的description文件，在description文件中，默认第一行是项目名称，所以要在第一行填入该项目的名称，这个在邮件中会有显示。

$ vim /opt/git/project.git/description

Project_A

把所有用户的公钥保存在 authorized_keys 文件的做法，只能凑和一阵子，当用户数量达到几百人的规模时，管理起来就会十分痛苦。每次改删用户都必须登录服务器不去说，这种做法还缺少必要的权限管理 — 每个人都对所有项目拥有完整的读写权限。

幸好我们还可以选择应用广泛的 Gitosis 项目。简单地说，Gitosis 就是一套用来管理 authorized_keys 文件和实现简单连接限制的脚本。有趣的是，用来添加用户和设定权限的并非通过网页程序，而只是管理一个特殊的 Git 仓库。你只需要在这个特殊仓库内做好相应的设定，然后推送到服务器上，Gitosis 就会随之改变运行策略，听起来就很酷，对吧？

Gitosis 的安装算不上傻瓜化，但也不算太难。用 Linux 服务器架设起来最简单 — 以下例子中，我们使用装有 Ubuntu 8.10 系统的服务器。

Gitosis 的工作依赖于某些 Python 工具，所以首先要安装 Python 的 setuptools 包，在 Ubuntu 上称为 python-setuptools：

---