软件需求:Git-core,gitosis, openssh-server, git-daemon-run(ubuntu),msysgit(windows)
Step1. 安装配置Git服务器(IP:192.168.1.101)
安装Git和openssh。
$ sudo apt-get install git-core openssh-server
新建用户git,该用户作为所有代码仓库和用户权限的管理者。
$ sudo groupadd git
$ sudo useradd git –g git –m
$ sudo passwd git (需要设置用户git的密码)
Step2. 安装gitosis
初始化服务器的全局设置,为安装gitosis做准备。在任何一台机器上使用git,第一次必须要先设置user.name和user.email。
$ git config --global user.name “david”
$ git config --global user.email “david@server-pc”(name和email随意)
安装一下Python的setup tool。
$ sudo apt-get install python-setuptools
获取gitosis包。
$ git clone https://github.com/res0nat0r/gitosis.git(或者到网上下载对应的gitosis)
$ cd gitosis
$ sudo python setup.py install
Step3. 配置gitosis
在git管理员的PC上,先安装msysgit(windows系统),安装后,打开gitbash,运行如下命令生成管理员密钥:
$ ssh-keygen –t rsa
运行以上命令后,可以默认提示直接回车。回车后在当前用户目录下生成了.ssh/id_rsa和.ssh/id_rsa.pub。其中.ssh/id_rsa是私玥,.ssh/id_rsa.pub是公钥。接下来可以使用如下命令将git管理员的公钥上传到git服务器,也可以直接拷贝到git服务器。
$ scp xxx/.ssh/id_rsa.pub webgod@192.168.1.101:/tmp/id_rsa.pub
回到Git服务器上。
$ sudo chmod a+r /tmp/id_rsa.pub
让gitosis运行起来:
$ sudo –H –u git gitosis-init
Initialized empty Git repository in /home/repo/gitosis-admin.git/
Reinitialized existing Git repository in /home/repo/gitosis-admin.git/
Gitosis是通过一个git仓库来管理配置文件,仓库放在/home/git/repositories/gitosis-admin.git。
设置git仓库权限
$ sudo chown git:git /home/git/repositories
$ sudo chmod 755 /home/git/repositories
$ sudo chmod 755 /home/git/repositories/gitosis-admin.git/hooks/post-update
Step4. 在服务器上新建测试项目仓库
在服务器上新建一个空的项目仓库可,叫“test”。
切换到git用户:
$ su – git
$ cd repositories
$ git init --bare test.git
$ exit
到这里,test只是一个空仓库,它是不能clone下来的。为了能做clone,必须先让管理员或有权限的人放一个初始化的版本到仓库中。所以,我们必须先修改一个gitosis-admin。
Step5. 管理gitosis的配置文件
Gitosis本身的配置也是通过git来实现的。在刚刚上传公钥(服务器端gitosis-init时使用了该公钥)的机器上,把gitosis-admin.git这个仓库clone下来,就可以以管理员的身份修改配置了。
新建一个文件夹,如git101:
$ mkdir git101
$ cd git101
$ git clone git@192.168.1.101:gitosis-admin.git(或使用全路径)
注:访问git用户仓库的默认路径是/home/git/repositories/
$ cd gitosis-admin
该目录下的keydir目录是用来存放所有需要访问git服务器的用户的ssh公钥。各个用户按照前面提到的办法生成各自的ssh公钥文件后,把所有人的ssh公钥文件按名字重新命名一下,然后拷贝到keydir目录下,然后修改gitosis.conf文件,做相应的配置:
[gitosis]
[group gitosis-admin]
writable = gitosis-admin
members = david@DAVID-PC tom@TOM-PC
[group team]
writable = test
members = david@DAVID-PC tom@TOM-PC pitter@PITTER-PC
这个配置文件表达了如下含有:gitosis-admin组成员有david,tom,该组对gitosis-admin仓库有读写权限;test组有david,tom,pitter三个成员,该组对test仓库有读写权限。目前这些配置文件的修改只是在本地,必须推送到远程的git服务器上才能真正生效。
加入新文件、提交并push到Git服务器:
$ git add .
$ git commit –m “add test and someusers”
$ git push origin master
Step6. 初始化测试项目
现在服务器搭建完毕,并且有一个空的项目test在服务器上。接下来,需要测试一下,空仓库是不能clone的,所以需要某个有写权限的人初始化一个版本。在客户端执行:
$ mkdir test-ori
$ cd test-ori
$ git init (在客户端执行,初始化一个本地的版本库)
$ echo “/* add something */” > hello.c
$ git add .
$ git commit –m “initial version”
$ git remote add origin git@192.168.1.101:test.git
$ git push origin master
到此为止,test已经有了一个版本了,team的其他成员只要先clone一下test仓库就可以了,而且gitosis.conf中赋予的读写权限。
Step7. 添加已有git项目
如果想将一个现成的git仓库,放到Git服务器上供team使用(比如clone了一个官方的kernel仓库,想在内部使用它作为基础仓库),可以这样操作:
首先需要从你的工作仓库中得到一个纯仓库,比如你的工作目录为~/kernel,你想将该纯仓库拷贝到Git服务器上使用。Git服务器的管理员拿到这个纯仓库(~/kernel)后,将其拷贝到/home/repo/下,同时配置gitosis相关配置文件。比如说:下载ALSA库。
$ git clone git://Android.git.kernel.org/platform/external/alsa-lib.git
$ git clone git://android.git.kernel.org/platform/external/alsa-utils.git
生成bare库:
$ git clone --bare alsa-lib alsa-lib.git
$ git clone --bare alsa-utils alsa-utils.git
将bare库移动到Git服务器目录:
$ cp alsa-lib.git /home/repo
注意变更所有者,以获取提交权限。
$ chown -R git alsa-lib.git
Step8. 安装git-daemon
如果想使用git协议,那么就需要安装git-daemon,它是git的一个守护进程(作为一个服务存在)。
$ sudo apt-get install git-daemon-run
编辑git-daemon配置文件:
$ sudo gedit /etc/sv/git-daemon/run
#!/bin/bash
exec2>&1
echo‘git-daemon starting.’
execchpst -ugitdaemon
“$(git--exec-path)”/git-daemon --verbose --export-all--enable=receive-pack --enable=upload-pack --enable=upload-archive --reuseaddr --base-path=/home/webgod/
说明:
--base-path 指向Git服务器的根目录
--enable=receive-pack
--enable=upload-pack
--enable=upload-archive
以上三个是与git-clone,git-push,git-pull相关的。查看详情使用命令:$ man git-daemon查看。
重启git服务器:
$ sudo sv restart git-daemon
在Git服务器上:
$ cd /home/webgod
$ mkdir RepoServer
$ cd RepoServer
$ git init --bare manifest.git
切换到其他目录:
$ cd ~/test
$ git clone git://127.0.0.1/RepoServer/manifest.git
($ git clone git@127.0.0.1:/home/webgod/RepoServer/manifest.git)
这里就实现了所谓的“匿名访问”。
[说明]:
1.如果其它新加入的成员无法clone一个git仓库时,如出现如下错误提示:
ERROR: gitosis.serve.main:Repositoryread access denied
原因是当前成员的key命名与在gitosis.conf中的members中的名字不一致!例如所用的key名是 lxq_rsa.pub,而在gitosis.conf中某一group下所用的名称为 lxq@ubuntu
则只需要把lxq_rsa.pub重命名为lxq@ubuntu.pub并重新push到服务器上即可!
2. 在克隆仓库时如果出现如下错误提示:
fatal: ‘~/gitosis-admin.git’ does not appear to be a gitrepositories
fatal: The remote end hung up unexpectedly
试用 $ git clone git@192.168.1.101:/home/git/repositories/gitosis-admin.git
3.使用公钥认证的方式登录。具体操作过程如下:
1) 在服务器端(server)创建一个账号(公共),例如anonymous;
2) 管理员收集需要访问git服务的用户公钥,如user1.pub、user2.pub;
3) 使用ssh-copy-id命令将各个git用户的公钥远程加入服务器(server)的公钥认证列表。
远程操作,可以使用ssh-copy-id命令:
$ ssh-copy-id -I user1.pub anonymous@server
$ ssh-copy-id -I user2.pub anonymous@server
如果直接在服务区上操作,则直接将文件追加到authorized_keys文件中:
$ cat /path/to/user1.pub>> ~anonymous/.ssh/authorized_keys
$ cat/path/to/user2.pub >> ~anonymous/.ssh/authorized_keys