当前位置: 首页 > 工具软件 > Gitosis > 使用案例 >

Gitosis

邢思淼
2023-12-01

http://blog.sina.com.cn/s/blog_79fded950101e1lf.html


什么是 Gitosis ?

git作为一个分布式的版本控制系统,其实client端和server的差别并不是很大,只是server端往往没有工作拷贝的需求,所以往往是 一个裸库(bare repository),往往文件夹的名称为xxxx.git ,裸库的内容其实就相当于客户端某个工程下的.git目录了.


使用git的时候,一般和服务器通讯使用的是ssh协议,用ssh的主要优点是速度快(传输前数据会先压缩,比HTTP快),安全,方便读写。 客户端通过ssh访问服务器端的验证方式一般有两种,一种是用户名密码的方式,一种是使用公私钥认证的方式. 使用公私钥的方式比较方便,无需每次登录输入密码。 某个受信任的客户端的公钥会被设置在服务器端的 ~/.ssh/authorized_keys文件中,有关此文件的格式可以参见 sshd的用户手册 man sshd . authorized_keys有个比较厉害的功能是 支持 command参数,使得每次用户使用此公钥进行验证的时候执行此后面的命令.这样就可以做一些逻辑处理了.


一般git库的管理需要权限控制,如何方便简单的进行库的权限管理呢? authorized_keys是一个思路,指定特定command参数,每次验证好用户后首先执行相关逻辑,检测当前用户是否具有某个权限。 所以便有了gitosis,与其说gitosis是一个git权限管理系统,还不如说它是一个authorized_keys文件管理器.
gitosis的设计思路很巧妙,开天辟地之初,需要一个gitosis的管理员,所以你就在你的客户端机器上生成一对公私钥,将公钥拷贝到git服务器 端的/tmp/下,然后通过gitosis在git用户home目录下运行如下初始化命令,后面的公钥便是gitosis首个管理员的公钥

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

执行之后,home目录下出现一个repositories的目录,目录下存在一个gitosis-admin.git的git库. 其实gitosis就是通过这个git库来管理所有git库的访问权限的。
在刚才你的客户端机器上clone出这个库,因为你刚刚用你的公钥初始化了gitosis,所以你有权限访问服务器端的库(其实你可以在服务器端看看 authorized_keys文件便知道原因了)。 这个gitosis-admin的库中存在一个gitosis.conf和一个keydir的目录,gitosis.conf文件就是权限配置的地 方,keydir目录下存放的是所有客户端的公钥,公钥名字必须和配置文件中的member名字对应.至于gitosis.conf的语法及用法可以去查 看帮助。
当修改完配置和添加好需要添加的公钥之后,提交并push到git服务器,这个库的存在hook,当提交后,会根据新的配置和公钥去更新服务器端git用 户的authorized_keys,以便加入新用户的公钥,用于权限控制命令,以及在裸库的目录下提取出新的gitosis.conf文件。


所以 gitosis的核心在于authorized_keys的command参数和git的hook功能.

原文地址 :http://geeklu.com/2012/10/gitosis/

 

           ---------------Gitosis 配置使用 -----------------

以下出自:http://blog.haohtml.com/archives/12658

说明:由于条件有限,我这里使用的是同一台centos的,但教程内容基本上通用。

1.编译安装git

git安装教程:http://blog.haohtml.com/archives/10093

2.安装gitosis
  1. yum install python python-setuptools
  2. git clone git://github.com/res0nat0r/gitosis.git
  3. cd gitosis
  4. python setup.py install
3.在开发机器上生成公共密钥(用来初始化gitosis)
  1. ssh-keygen -t rsa #不需要密码,一路回车就行(在本地操作)
  2. scp ~/.ssh/id_rsa.pub root@xxx:/tmp/ 上传你的ssh public key到服务器
4.初始化gitosis[服务器端]
  1. adduser git 新增一个git用户(先添加用户组 groupadd git)
  2. su git 切换倒git用户下
  3. gitosis-init /tmp/id_rsa.pub id_rsa.pub是刚刚传过来的,注意放在/tmp目录主要是因为此目录权限所有人都有定权限的
  4. rm /tmp/id_rsa.pub id_rsa.pub已经无用,可删除.
5.获取并配置gitosis-admin [客户端]
  1.  git clone git@xxx:gitosis-admin.git  # 切换到root用户并在本地执行,获取gitosis管理项目,将会产生一个gitosis-admin的目录,里面有配置文件gitosis.conf和一个 keydir 的目录,keydir目录主要存放git用户名
  2.  vi gitosis-admin/gitosis.conf  编辑gitosis-admin配置文件
如果无法git clone的话,可以使用 git clone git@xxx:/home/git/repositories/gitosis-admin.git
# 在gitosis.conf底部增加
  1. [group 组名]
  2. writable 项目名
  3. members 用户  这里的用户名字 要和 keydir下的文件名字相一致
# VI下按ZZ(大写)两次会执行自动保存并退出,完成后执行
  1. $ cd gitosis-admin
  2. $ git add .
  3. git commit -a -m “xxx xx” 要记住的是,如果每次添加新文件必须执行git add .,或者git add filename,如果没有新加文件,只是进行修改的话就可以执行此句。
# 修改了文件以后一定要PUSH到服务器,否则不会生效。
  1. git push
如果在git push的时候,遇到错误“ddress 192.168.0.77 maps to bogon, but this does not map back to the address - POSSIBLE BREAK-IN ATTEMPT!”,解决为修改/etc/hosts文件,将ip地址与主机名对应关系写进去就可以了。
注意:这里我们并没有进行任何的修改的,现在只有一个管理git的项目。下面的为新添加项目的配置,大家经常用到的也就是下面的操作的。
新建项目
到此步就算完成gitosis的初始化了。接下来的是新建一个新项目到服务器的操作,如第5步中配置gitosis.conf文件添加的是
  1. [group project1] 组名称
  2. writable project1 项目名称
  3. members xxx      用户名xxx一定要与客户端使用的用户名完全一样,否则无权限操作
 提交修改并更新到git server服务端
  1. git commit -a -m “添加新项目project1,新项目的目录是project1,该项目的成员是xxx“ “”里的内容自定
  2. git push
将新创建的项目提交到git server 上进行登记。以便客户可以操作新项目.
# 在客户端创建项目目录 (客户端,当前用户为 XXX )
现在回到开发者客户端,上面创建了一个新项目project1并提交到了git server 。我们这里就创建此项目的信息.注意 项目名称  project1要与gitosis.conf文件配置一致,
  1. $ mkdir /home/用户/project1
  2. cd /home/用户/project1
  3. git init
  4. git add 新增文件 留意后面有一个点
  5. git commit -a -m “初始化项目project1″
# 然后就到把这个项目放到git server服务器上去.
  1. git remote add origin git@xxx:project1.git xxx为服务器地址
  2. git push origin master
# 也可以把上面的两步合成一步
  1. git push git@xxx:project1.git master

说明:如果在执行 git push origin master 的时候,提示以下错误:
error: src refspec master does not match any.
error: failed to push some refs to 'git@192.168.0.77:pro2.git'

这是由于项目为空的原因,我们在项目目录里新创建一个文件。经过->add -> commit -> push 就可以解决了

  1. $ touch a.txt
  2. $ git add a.txt
  3. $ git commit -a -m 'add a.txt'
  4. $ git push

------------添加用户的----------------

把用户电脑上的公钥 cp到服务器上。然后

su git   切换到git用户下 存放其他用户端的公钥

只要把它们逐个追加到 authorized_keys 文件尾部即可:

$ cat /tmp/id_rsa.john.pub >> ~/.ssh/authorized_keys 
$ cat /tmp/id_rsa.josie.pub >> ~/.ssh/authorized_keys 
$ cat /tmp/id_rsa.jessica.pub >> ~/.ssh/authorized_keys
然后 vi gitosis.conf 文件风别在members =  josie  john  jessica
添加这些用户 

客户就直接可以 使用
git clone git@serverIp:gitosis-admin.git  把远程的项目clone到本地

------------------------------------------------------------------------------------------------

如果在git clone的时候遇到“

error: cannot run ssh: No such file or directory - cygwin git

”错误,则表示本机没有安装ssh命令。安装方法请参考:http://blog.haohtml.com/archives/13313

有时候我们要更换电脑来重新开发项目。这个时候,只需要将id_rsa私钥放在home目录里的.ssh目录里就可以了。(有时候一个人开发多个项目,这时候可能会提示id_rsa文件已经存在。不太清楚这里如何解决???)

续篇:git下添加新项目及用户

====================================================

三、常见问题

首先确定 /home/git/repositories/gitosis-admin.git/hooks/post-update 为可执行即属性为 0755

1. git操作需要输入密码

原因
公密未找到
解决
上传id_rsa.pub到keydir并改为'gitosis帐号.pub'形式,如miao.pub。扩展名.pub不可省略

2. ERROR:gitosis.serve.main:Repository read access denied

原因
gitosis.conf中的members与keydir中的用户名不一致,如gitosis中的members = foo@bar,但keydir中的公密名却叫foo.pub
解决
使keydir的名称与gitosis中members所指的名称一致。
改为members = foo 或 公密名称改为foo@bar.pub

-------------------其他相关---------------------------------

git 分支的策略 http://www.ruanyifeng.com/blog/2012/07/git.html


-----------以下是推荐的git详解的文章 写的很到位 ----------

http://www.open-open.com/lib/view/open1328069609436.html


-----------------------一下是分支上传和提交 --------------------


|--新建分支(客户端)
git branch testgitest
(服务器端)
git branch testgittest
 
|--这个是建立远程track的过程 (也就是把本地的分支testgittest推送到服务器上的testgittest)
git push origin testgittest:orgin/testgittest`
 git fetch origin

From 121.199.16.233:/home/git/repositories/testgit
 * [new branch]      remotetestgittest -> origin/remotetestgittest

|---再分支我上提交
git checkout testgittest
git pull
git fetch origin
git add .
git commit -a -m 'add testgit.var'
|--master 合并提交
git merge testgittest

git push --set-upstream git@YouServerIp:/home/git/repositories/testgit.git testgittest
git push  git@YouServerIp:/home/git/repositories/testgit.git testgittest
或者不用上面的两句
直接
 git push 就ok 其他的
--------------以上是的流程是 先建一个分支testgittest--------------
其他人就就直接在本地 git pull 就直接把文件同步过来了

若又其他疑问 参见

http://www.open-open.com/lib/view/open1328069889514.html

http://www.open-open.com/lib/view/open1370250692148.html

相关阅读

相关文章

相关问答