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",例如“jone@example.com.pub”)。
六、添加用户和仓库
添加新仓库也非常简单,假设你要添加一个叫jone@example.com的用户,再创建一个仓库叫myproject,并赋给jone修改权限。
1.首先ssh-keygen生成jone的公钥和私钥;
2.把jone公钥拷贝到本地gitosis-admin库的keydir里面;
3.编辑本地gitosis-admin库里的gitosis.conf,添加:
[group myteam]
members = jone@example.com
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/里面。