ubuntu 使用gitosis和gitweb安装git服务器

【转载请注明原文链接：http://kowen.iteye.com/blog/2101784】

 

经过多天的摸索，终于在ubuntu上配置完成了gitosis，写下来分享：

 

一、安装环境和软件

ubuntu 14.04 server

openssh-server

git-core

gitosis

git

 

二、安装准备

1.服务器安装openssh

 sudo apt-get install openssh-server openssh-client

2.在一台管理客户机上生成ssh公钥【客户机执行】

 ssh-keygen -t rsa

生成的公钥在/home/YourUserName/.ssh/里面，默认名字是id_rsa.pub。

 

 

三、安装git服务

sudo apt-get install git-core 

 

四、安装gitosis

1.下载gitosis到/tmp

cd /tmp

git clone https://github.com/tv42/gitosis.git

2.安装必备包

sudo apt-get install python-setuptools

3.安装gitosis

cd /tmp/gitosis

python setup.py install

 

五、配置gitosis

1.创建用户git【服务器执行】

sudo adduser \

     --system \

     --shell /bin/sh \

     --gecos 'git version control' \

     --group \

     --disabled-password \

     --home /git \

     git

 

2.把管理客户机生成的公钥上传到服务器上【客户机执行】

scp /～.ssh/id_rsa.pub git@<server>:/tmp

或者用其他方式上传到服务器也行

 

3.初始化配置【服务器执行】

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

以上命令有三个作用：

a)建立一个目录“~/repositories”，用来存储所有git仓库；

b)生成一个指向实际配置文件的软链接“~/.gitosis.conf”；

c)把公钥文件id_rsa.pub添加到 ～/.ssh/authorized_keys。

执行后提示：

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

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

 

执行命令“l /git -all”可以看到配置产生的结果：

total 20

drwxr-xr-x  5 git  git  4096 Aug  7 15:33 ./

drwxr-xr-x 23 root root 4096 Aug  7 15:07 ../

lrwxrwxrwx  1 git  git    48 Aug  7 15:33 .gitosis.conf -> /git/repositories/gitosis-admin.git/gitosis.conf

drwx------  2 git  git  4096 Aug  7 15:33 .ssh/

drwxr-xr-x  2 git  git  4096 Aug  7 15:33 gitosis/

drwxr-xr-x  3 git  git  4096 Aug  7 15:33 repositories/

 

4.修改配置文件

有趣的是，gitosis的配置文件本身就是一个git仓库，gitosis的配置修改就是通过git实现的，先clone下来修改，再push上去。只要push上去，gitosis会立刻监视到配置文件的修改并应用。

在管理客户端clone管理库到本地：git clone git@<SERVER>:gitosis-admin.git

clone下来以后，库里有一个文件gitosis.conf（配置文件）；还有一个文件夹keydir，里面存储的是用户的公钥文件，当前里面就有在管理客户端上生成的私钥（用户名格式是"email地址.pub"，例如“[e-mail]”）。

 

六、添加用户和仓库

添加新仓库也非常简单，假设你要添加一个叫[e-mail]的用户，再创建一个仓库叫myproject，并赋给jone修改权限。

1.首先ssh-keygen生成jone的公钥和私钥；

2.把jone公钥拷贝到本地gitosis-admin库的keydir里面；

3.编辑本地gitosis-admin库里的gitosis.conf，添加：

[group myteam]

members = [e-mail]

writable = myproject

4.commit修改，push到服务器生效。

5.使用jone初始化仓库并push到服务器【在jone私钥计算机上操作】

mkdir myproject

cd mypyroject

git init

git remote add myserver git@MYSERVER:myproject.git

# do some work, git add and commit files

git push myserver master:refs/heads/master

 

【更复杂的配置文件的样例见：https://github.com/tv42/gitosis/blob/master/example.conf】

 

七.设置gitweb

1.安装gitweb

sudo apt-get install gitweb

安装后，配置文件是/etc/gitweb.conf，其他文件在/usr/share/gitweb/。

 

2.链接/var/www到gitweb的网页目录

$ cd /var/www/

$ sudo ln -s /usr/share/gitweb/static/

 

3.修改gitweb配置文件sudo vi /etc/gitweb.conf

 

#配置仓库所在目录

$projectroot = "/git/repositories";

#配置project list

$projects_list = "/git/gitosis/projects.list";

#以下配置网页静态文件，注意"/"

@stylesheets = ("/static/gitweb.css");

$javascript = "/static/gitweb.js";

$logo = "/static/git-logo.png";

$favicon = "/static/git-favicon.png";

 

 

4.安装lighttpd

sudo apt-get install lighttpd

 

5.修改lighttpd配置文件 sudo vi /etc/lighttpd.conf

 

server.modules  += (

  "mod_cgi",

  "mod_setenv",

  "mod_redirect",

  #保证以上三个module都有

)

 

url.redirect += (

  "^/gitweb$" => "http://YOURSERVER/gitweb/",

)

alias.url += (

  "/gitweb/" => "/usr/lib/cgi-bin/gitweb.cgi",

  "/gitweb.css" => "/var/www/static/gitweb.css",

  "/git-logo.png" => "/var/www/static/git-logo.png",

  "/git-favicon.png" => "/var/www/static/git-favicon.png",

)

 

$HTTP["url"] =~ "^/gitweb/" {

  setenv.add-environment = (

    "GITWEB_CONFIG" => "/etc/gitweb.conf",

  )

  cgi.assign = ( "" => "" )

}

 

6.配置要显示的仓库

编辑配置文件：sudo vi /git/.gitosis.conf

[repo myproject]

gitweb = yes

description = example repo

owner = yourname

daemon = yes

 

[gitweb]

 

7.重启lighttpd服务 

sudo service lighttpd reload

 

8.打开浏览器，输入http://YOURSERVER/gitweb，可以显示首页，但是提示404错误（找不到仓库）；

最后找到原因是/git/repositories/myproject.git目录权限的问题，只有git用户有读写权限，所以lighttpd服务无法读取这个目录，这里设置777权限给它：“sudo chmod -R 777 /git/repositories/myproject.git”，刷新网页后ok。

 

八.总结

ubuntu安装git主要用到了ssh-keygen、git-core、gitosis、gitweb和lighttpd。

gitosis的配置文件是{git_user_home}/.gitosis.conf；

gitweb的配置文件是/etc/gitweb.conf

lighttpd的配置文件在/etc/lighttpd/里面。