原文链接:http://www.cnblogs.com/ytliyang/archive/2012/02/12/2347987.html

 

Gitosis 是一个使用SSH管理Git仓库的服务端工具,有意思的是,该软件用来添加用户和设定权限的界面不是网页,而是一个特殊的 Git 仓库。你只需要设定好某个项目,然后推送,Gitosis 就会随之改变服务器设定,酷!

        在Linux下的安装方法已经非常成熟,上网Google一下就有很多,而在Windows下的安装则花了我不少功夫,只要是有时候碰到问题无从入手,以下将整个安装过程详细记录下来。

总体分为如下几大步骤:

一)下载安装Cygwin

1)到http://www.cygwin.com/官方网站下载 Cygwin 的在线安装程序 setup.exe

2)以管理员身份运行setup.exe开始安装Cygwin

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_windows

3)Cygwin安装过程截图

点击下一步继续

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_windows_02

选择“Install from Internet”

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_python_03

设置Cygwin的安装路径Root Directory,选择“All Users(RECOMMENDED)”

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_dependencies_04

设置Cygwin在线下载的数据包的保存路径Local Package Directory

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_git_05

选择“Direct Connection”

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_processing_06

选择下载文件的镜像地址后点击下一步(选择不同的地址会影响下载速度)

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_服务器_07

开始下载相关数据包

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_服务器_08

如果是首次安装Cygwin,将会弹出如下界面,点击确定继续即可

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_windows_09

选择默认并没有包含的相应包,包括:

  • devel 分类下的 git
  • net 分类下的 openssh
  • Python 分类下的 python(这里顺便记录一下python的版本号,后面会用到,如2.6)
  • Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_processing_10

点击下一步继续 

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_服务器_11

到了漫长的下载等待界面了 

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_processing_12

点击完成后Cygwin就安装完毕了 

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_processing_13

二)修改安装后相关目录的访问权限

进入“开始/所有程序/Cygwin/Cygwin Bash Shell”,右键以管理员身份运行“Cygwin Bash Shell”,在命令行中分别运行如下命令:

$ chmod +r /etc/passwd
$ chmod u+w /etc/passwd
$ chmod +r /etc/group
$ chmod u+w /etc/group

运行的截图如下:

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_python_14

三)安装 ssh 守护进程服务

继续执行如下命令:

$ ssh-host-config

根据命令的提示分别回答:yes、yes、yes、ntsec tty、no、yes、[密码]、[重复密码],参考如下截图:

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_dependencies_15

至此ssh服务安装完毕!

打开Windows的命令行,运行“> net start sshd”启动ssh服务(也可以到Windows服务中启动)。

 

四)在Windows防火墙内开放上述 ssh 服务需要的22端口

进入“控制面板/系统与安全/Windows防火墙/高级设置(在左边栏)”,添加新的入站规则:

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_服务器_16

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_python_17

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_processing_18

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_processing_19

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_python_20

名称可以根据自己的喜好相应修改。

 

五)安装python setuptools

先设置python路径的访问权限,保证所有用户都可以访问:

$ chmod +r /lib/python2.6/ -R

2.6是所安装python的版本号,要对上你安装的版本号才行,我装的时候是2.6,如果忘记了,可以在Cygwin的命令终端输入“$ python -v”查看一下。

 

到 Python Package Index 主页下载对应版本的python setuptools,如2.6版对应要下载 setuptools-0.6c11-py2.6.egg

将setuptools-0.6c11-py2.6.egg复制到/home/your_user_name目录下(也可以按自己的需要复制到其它地方,注意下面的运行路径正确即可),然后在该目录的Cygwin终端下运行如下命令安装:

$ ./setuptools-0.6c11-py2.6.egg

看到输出类似如下的信息就表示安装成功了:

Processing setuptools-0.6c11-py2.6.egg
Copying setuptools-0.6c11-py2.6.egg to /usr/lib/python2.6/site-packages
Adding setuptools 0.6c11 to easy-install.pth file
Installing easy_install script to /usr/bin
Installing easy_install-2.6 script to /usr/bin

Installed /usr/lib/python2.6/site-packages/setuptools-0.6c11-py2.6.egg
Processing dependencies for setuptools==0.6c11
Finished processing dependencies for setuptools==0.6c11

 

六)安装配置Gitosis

1) 运行如下命令将Gitosis管理端的git仓库下载下来:

$ mkdir sources
$ cd sources 
$ git clone git://eagain.net/gitosis.git

2) 下载成功后再运行如下命令进行初始化:

$ cd gitosis 
$ python setup.py install

这将会输出一大堆的信息,如果没有出现问题,最后那一行输出的信息类似于“Finished processing dependencies for gitosis==0.2”。

 

3) 到“控制面板/用户帐户和家庭安全”添加一个账户名称为“git”的帐号,密码自定,类型选标准用户即可。

 

4) 继续在Cygwin终端运行如下命令,将刚添加的git帐号添加到Cygwin的passwd文件:

$ mkpasswd -l -u git >> /etc/passwd

再使用你喜欢的任何方式查看一下passwd文件(文件的最后那一行),确认git帐号已经添加进去。

 

5) 拷贝你的公钥文件到目录“/tmp/id_rsa.pub”,再在终端运行“$ chmod 755 /tmp/id_rsa.pub”修改文件的权限

    如果你还没有相应的公钥,就自己生成一个,参考GitHub Guide上的“Set Up SSH Keys”指引或参考基于互联网的Git开发环境搭建(Windows系统)中第3点“ 生成 Git 要使用的 ssh key”的相关指引。

6)以git用户打开一个新的Cygwin终端(如下图所示,位置在开始/所有程序/Cygwin)

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_dependencies_21

在该终端内运行如下命令初始化公钥的配置:

$ gitosis-init < /tmp/id_rsa.pub

如果你运气好的话,成功后你将会看到如下信息:

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_git_22

如果出现错误,参考下面第7步的处理

7)如果第6步出现类似如下错误信息:

0 [main] python 4268 D:\cygwin\bin\python.exe: *** fatal error - unable to remap \\?\D:\cygwin\lib\python2.6\lib-dynload\select.dll to same address as parent: 0x3E0000 != 0x410000

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_dependencies_23

按如下说明处理:

    关闭所有当前打开的所有Cygwin终端窗口,停止sshd服务,然后打开Windows的CMD命令行窗口,切换到cygwin/bin目录,运行 ash命令,会出现$命令行,继续输入“$ /bin/rebaseall”,如果没有任何错误信息就OK了,参考如下截图:

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_windows_24

错误处理完毕后,重新启动sshd服务,再按上面第6步重新操作一遍即可。

 

8)切换回以管理员身份打开的那个Cygwin终端窗口(如果因第7步已经关闭则重新打开一个),运行如下命令

$ chmod 755 /home/git/repositories/gitosis-admin.git/hooks/post-update

至此Gitosis成功安装完毕!

 

七)使用Gitosis

1)将Gitosis管理端的git仓库检出来,位置随意

$ git clone git@your-server-name:gitosis-admin.git

以下尝试创建一个test仓库,并配置访问权限。

2)进入刚刚检出的目录gitosis-admin,编辑gitosis.conf文件,增加如下信息:

[group test]
writable = test
members = your_email_from_ssh_key

保存,并提交、push到gitosis-admin.git仓库。

 

3)在你喜欢的地方创建一个空目录test,里面放个readme.txt文件,然后打开Git Bash终端,进入到test目录内运行如下命令,test.git仓库就会在服务端自动创建了(注意经过第2步后是不能直接"$ git clone"出来的,会报错,必须自己有个非空的git仓库然后push上去才行)。

$ git add .
$ git init
$ git commit -m init
$ git remote add origin git@your-server:test.git
$ git push origin master

现在你到“cygwin\home\git\repositories”目录下看看,test.git仓库已经稳放在那里了!

test仓库只是一个原理演示,任何其他的git仓库操作是类似的。

 

 

参考资料:

Setting up Gitosis on Windows 7

python.exe: *** fatal error - unable to remap

Git 服务器软件 gitosis 的改进

Pro Git:服务器上的Git 权限管理器Gitosis

Gitosis自身的Readme

 

还有个git仓库管理工具叫gitolite,用perl写的,听说可以控制到分支的权限等更多功能,有兴趣的可以参考一下下面的链接:

Gitolite 构建 Git 服务器

 

碰到的错误记录:

1)2011-05-27 启动sshd服务报错 "错误1069:由于登录失败而无法启动服务"

这是由于用户密码错误导致的,以后更改用户后sshd也可能发生这个问题,在 services.msc 里的登录标签里更改用户设置即可!

我刚好是碰到帐号cyg_server处于"用户下次登录时须更改密码"状态,修改为"密码永不过期"后sshd就启动正常了。

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_git_25

Win 7下安装 Gitosis (Windows下的 git 服务器)  Cygwin_dependencies_26