gitosis:
把所有用户的公钥保存在 authorized_keys 文件的做法,只能凑和一阵子,当用户数量达到几百人的规模时,管理起来就会十分痛苦。每次改删用户都必须登录服务器不去说,这种做法还缺少必要的权限管理 — 每个人都对所有项目拥有完整的读写权限。
简单地说,Gitosis 就是一套用来管理 authorized_keys 文件和实现简单连接限制的脚本。有趣的是,用来添加用户和设定权限的并非通过网页程序,而只是管理一个特殊的 Git 仓库。你只需要在这个特殊仓库内做好相应的设定,然后推送到服务器上,Gitosis 就会随之改变运行策略
安装配置git
- root@development 为服务器端 ,ip为:192.168.4.26
- iMACdeiMac:~ root 为服务器管理员
1.安装git和openssh。在当前用户下执行如下命令安装git和openssh:
root@development:~# sudo apt-get install git-core openssh-server openssh-client
git-core是git版本控制核心软件
安装openssh-server和openssh-client是由于git需要通过ssh协议来在服务器与客户端之间传输文件
如果安装提示失败,可能是因为系统软件库的索引文件太旧了,先更新一下就可以了,更新命令如下:
sudo apt-get update
2.配置git用户与创建git仓库的存储目录:
- 创建所有代码仓库和用户权限的管理者git,并更改用户的密码。在当前用户下执行:
root@development:~# sudo passwd git```
useradd会在ubuntu上增加一个git用户
- 创建git仓库的存储目录、更改文件目录属主为代码仓库的管理者git,只让git用户对此目录有权限。本文档以/home/repo目录做为git仓库的存储目录。在当前用户下执行:
root@development:~# sudo mkdir /home/repo
root@development:~# sudo chown git:git /home/repo
root@development:~# sudo chmod 700 /home/repo
安装配置gitosis
1.安装gitosis前准备
- 初始化git用户。在任何一台机器上使用git,第一次必须初始化一下。在当前用户下初始化全局的git信息(用户名和邮箱随便填写都可以,只是为了让git识别git用户而已):
首先查看一下是否存在了git用户执行命令:
root@development:~# cat ~/.gitconfig
若已有git用户,最好删除了重新初始化,我搭建时就是因为用了已有的git用户,后面搭建出问题了,删除命令:
root@development:~# sudo userdel -r git
初始化git命令:
root@development:~# git config --global user.name "jackliu"
root@development:~# git config --global user.email "xcltl618@gmail.com"
2.安装python的setup tool。在当前用户下执行如下命令安装:
/tmp是Ubuntu各种安装包与文件的存放的目录
root@development:~# cd /tmp
克隆下载gitosis包:
root@development:/tmp# git clone https://github.com/res0nat0r/gitosis.git
进入gitosis目录:
root@development:/tmp# cd gitosis
安装gitosis:
root@development:/tmp/gitosis# sudo python setup.py install
3.默认状态下,gitosis会将git仓库放在 git用户的home下,所以我们做一个链接到/home /repo,su到git用户,执行如下命令:
root@development:/tmp/gitosis# su git
git@development:/tmp/gitosis$ ln -s /home/repo /home/git/repositories
然后退出git用户:
git@development:/tmp/gitosis$ exit
4.配置gitosis。如果你是git服务器的管理员,在你的计算机上(最好是另一台PC)来生成访问git服务器的ssh公钥,然后将生成的公钥拷贝到git服务器,执行相关命令来允许你用个人的计算机进行访问和管理git服务器。本文档以mqt@iMACdeiMac.local来做为远程访问和控制git服务器的管理用户。如果另外一台电脑还是linux的电脑,还要在linux上安装上git(传送下载地址http://git-scm.com/downloads),并且初始化用户git config那两句命令
如果是linux 或 苹果系统,在此计算机上的/home/git目录下(随便一个目录都行)
- 在你的PC上选择一个用户做为远程访问及管理git服务器的用户,同时并生成ssh公钥。在选中的用户的home下,执行如下命令:
iMACdeiMac:~ root# ssh-keygen -t rsa
一直回车就行了,不需修改文件名
- 接着,将生成的公钥拷贝到服务器的/tmp下,注意要把改成git服务器对应的IP地址:
为了保险一点,你最好去看看服务器端/tmp目录下是否有id_rsa.pub,若有,把它删除了
iMACdeiMac:~ root# scp .ssh/id_rsa.pub git:192.168.4.26/tmp
输入服务器登录密码,拷贝成功,如下图:
如果拷贝不成功,你也可以直接用U盘拷贝id_rsa.pub到这台服务器上到/tmp目录下,最坏的情况是不能拷贝的话,可以在服务器的/tmp下创建一个id_rsa.pub文件,内容为:git服务器的管理员的id_rsa.pub里的内容(即刚才生成的id_rsa.pub文件的内容)
- 回到git服务器/tmp/gitosis目录,执行:
root@development:/tmp/gitosis# sudo chmod a+r /tmp/id_rsa.pub
- 在git服务器上执行如下命令,让gitosis运行起来:
root@development:/tmp/gitosis# sudo -H -u git gitosis-init < /tmp/id_rsa.pub
会出现如下信息:
Initialized empty Git repository in /home/repo/gitosis-admin.git/
Reinitialized existing Git repository in /home/repo/gitosis-admin.git/
- gitosis通过一个git仓库来管理配置文件,仓库放在/home/repo/gitosis- admin.git。我们需要为一个文件加上可执行权限,以root用户登录(我操作是一直是以root用户的):
root@development:/tmp/gitosis# cd /home/git/repositories
root@development:/home/git/repositories# cd gitosis-admin.git/
root@development:/home/git/repositories# sudo chmod 755 /home/repo/gitosis-admin.git/hooks/post-update
然后退出(退不退root无所谓):
root@development:/home/git/repositories# exit
在git服务器上搭建测试项目库
1.建立仓库名“test”的测试仓库。在git服务器上切换到git用户,执行如下命令建立测试仓库:
root@development:/home/git/repositories/gitosis-admin.git# su - git
git@development:~$ cd /home/repo
git@development:/home/repo$ mkdir test.git
git@development:/home/repo$ cd test.git
git@development:/home/repo/test.git$ git init --bare
git@development:/home/repo/test.git$ exit
到目前为止,这只是一个空仓库,空仓库是不能clone的。为了能clone,我们必须先让某个有权限的人放一个初始化的版本到仓库
中。所以,我们必须先修改一下gitosis-admin。此时需要 管理gitosis的配置文件。
2.gitosis本身的配置也是通过git中的gitosis-admin.git来实现的。
- 克隆gitosis-admin.git仓库。在git管理员用户目录下,把gitosis-admin.git这个仓库clone下来,接下来我们可以用管理员的身份修改配置了。
在git管理员用户目录执行:
iMACdeiMac:~ root# cd /Users/imac/Documents/gtis
我把gitosis-admin.git放在/Users/imac/Documents/gtis这个目录下
iMACdeiMac:gtis root# git clone git@192.168.4.26:gitosis-admin.git
在windows电脑上git base下一样执行这个克隆命令
如果出现:fatal: '~/gitosis-admin.git' does not appear to be a git repository
fatal: The remote end hung up unexpectedly
改成: sudo git clone git@192.168.4.26:/home/repo/gitosis-admin.git
- 拷贝需要访问git服务器的开发用户的ssh公钥 获取仓库后,执行:
进入到刚刚克隆的管理仓库
iMACdeiMac:gtis root# cd gitosis-admin/
该目录下的keydir目录是用来存放所有需要访问git服务器的用户的ssh公钥:各个用户按照前面提到的办法生成各自的ssh公钥文件后,把所有人的ssh公钥文件都拿来,按名字命名一下(#### 注意:在各个用户机上生成ssh公钥时不要修改文件名,粘贴到gitosis-admin下的keydir目录才修改文件名####),比如b@pc1.pub, lz@pc2.pub等,统统拷贝到keydir下:
iMACdeiMac:gtis root# su root //苹果系统下执行 sudo su - root
iMACdeiMac:gtis root# cp /path/.ssh/id_rsa.pub ./keydir/b@pc1.pub
iMACdeiMac:gtis root# exit
然后看看keydir目录下是否有b@pc1.pub,若这样的命令复制粘贴不行,直接手动复制粘贴到keydir目录下也行,windows下直接复制粘贴
- 修改gitosis.conf文件
[group gitosis-admin] # 组名称(可随意起)
members = mqt@iMACdeiMac.local b@pc1 #组员 :配置了两个服务器管理员,mqt@iMACdeiMac.local 和 b@pc1,因为gitosis-admin 项目是配置权限用的
writable = gitosis-admin # 组员对项目gitosis-admin有读写权限
[group hello] # 组名
members = mqt@iMACdeiMac.local b@pc1 # 为test项目配置两个组员
writable = test # 组员对项目test有读写权限
如果想为一个用户只配置读权限,而没有写权限,在文件上添加:
[group hello]
members = b@pc2
readonly = test # 组员b@pc2对项目test只有读权限
注意:members = keydir目录下.pub文件名,否则没有访问权限
目前这些配置文件的修改只是在你的本地,你必须推送到远程的gitserver上才能真正生效。 加入新文件、提交并push到git服务器:
iMACdeiMac:gitosis-admin root# git add .
iMACdeiMac:gitosis-admin root# git commit -am “add test prj and users”
iMACdeiMac:gitosis-admin root# git push origin master
gitosis.conf 文件的修改,起到的作用是:
gitosis-admin组成员有 mqt@iMACdeiMac.local, b@pc1, 该组对gitosis-admin仓库有读写权限;
hello组有mqt@iMACdeiMac.loca, b@pc1两个成员, 该组对test仓库有读写权限
测试搭建的项目库
- 服务器搭建完了,并且有一个空的项目test在服务器上。接下来测试一下,空仓库是不能clone的,所以需要某一个有写权限的人初始化一个版本。 下面是在b@pc1客户端完成:
mkdir test-ori
cd test-ori/
git init
echo “/*add something*/” > hello #创建一个说明文件
git add .
git commit -am “initial version”
git remote add origin git@192.168.4.26:test.git
git push origin master
这些命令一个都不能漏,到此,test已经有了一个版本了,test仓库的其他成员只要先clone一下test仓库,就可以进行仓库的开发了。下面是一个用户b来克隆test:
su b
cd /home/b
git clone git@192.168.4.26:test.git
cd teamwork
vim hello
git add .
git commit -am “b add”
git push origin master
exit
使用图形界面git(SourceTree)
- 拿到URL地址直接克隆仓库,以test.git为例:
现有项目上传
- 这个更简单,像创建test.git仓库一样,初始化仓库后,克隆本地仓库后把项目放到本地仓库再推送到服务器就ok了
配置gitweb
- 待定。。。。