使用Gitosis搭建Git服务器

软件需求: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 [email protected]:/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 [email protected]: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 [email protected]: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 [email protected]:/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重命名为[email protected]并重新push到服务器上即可!

2. 在克隆仓库时如果出现如下错误提示:

fatal: ‘~/gitosis-admin.git’ does not appear to be a gitrepositories

fatal: The remote end hung up unexpectedly

试用 $ git clone [email protected]:/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

关注获取it视频

使用Gitosis搭建Git服务器_第1张图片

你可能感兴趣的:(使用Gitosis搭建Git服务器)