Ubuntu下 git 服务器的搭建
手上的项目越来越多，就越来越发现离不开git类似的版本管理软件。毕竟需要做好版本管理
于是想到了在手上已有的服务器上安装搭建一个git服务器作为自己的代码管理中心。
废话少说，
另外，这个日志也还不错[url]http://blog.csdn.net/ice520301/article/details/6142503[/url]
感谢这几篇文章的作者：
[url]http://www.hackido.com/2010/01/installing-git-on-server-ubuntu-or.html[/url]
同时参考一下：
[url]http://www.debuntu.org/ssh-key-based-authentication[/url] 这篇文章介绍了SSH公钥和私钥的生成方法。
这篇文章里面介绍了新加用户的部分补充了第一篇文章的不足。
[url]http://www.jiangmiao.org/blog/1600.html[/url]
这篇文章介绍了ssh-keygen命令的参数
[url]http://lamp.linux.gov.cn/OpenSSH/ssh-keygen.html[/url]
我的安装步骤主要来源于上面引用的第一篇文章，并补充不足之处（比如原文第6条作者没说清楚）。
注意，Git是分布式管理工具，因此没有真正的Server，本文用了三台机器，分别是
S1 代表 机房里面的Ubuntu 11.10 server
C1 代表 第一台拥有管理权限的 Ubuntu desktop
C2 代表 后来被添加进来的拥有管理权限的Ubuntu desktop
三台机器都可以看作是服务器。只是从方便人使用的角度，总是将项目文件提交到S1上，并从S1上获得最新项目文件。
1.Ubuntu server安装Git服务程序
下文称这台Ubuntu server为S1
sudo apt-get install git-core
2.S1上安装Gitosis程序.
Gitosis是一个工具程序，可以帮助我们进行Git仓库的访问控制和远程管理。
sudo apt-get install python-setuptools
mkdir ~/src
cd ~/src
git clone https://github.com/res0nat0r/gitosis.git
cd gitosis
sudo python setup.py install
3.S1上创建一个git帐号。
没有密码。这个帐号是给Gitosis程序使用的。
sudo adduser \
--system \
--shell /bin/sh \
--gecos 'git version control' \
--group \
--disabled-password \
--home /home/git \
git
4.安装远程管理客户端
下文将第一个远程管理客户端称为C1
sudo apt-get install openssh-client
ssh-keygen
如果没有安装openssh-client，才需要第一行命令。ssh-keygen命令会创建公钥和私钥文件。将公钥文件复制到服务端。然后在S1上导入到Gitosis中以后C1就无需用户名和密码便能通过SSH连接服务端了。
scp /home/chenshu/.ssh/id_rsa.pub cncm@S1:/home/cncm
sudo -H -u git gitosis-init < /home/cncm/id_rsa.pub
得到下面的结果：
Initialized empty Git repository in /home/git/repositories/gitosis-admin.git/
Reinitialized existing Git repository in /home/git/repositories/gitosis-admin.git/
意思是S1上已经成功创建了仓库目录，路径是/home/git/repositories，并且里面还创建了一个管理员仓库，叫gitosis-admin。
修改S1上一个文件的权限：
sudo chmod 755 /home/git/repositories/gitosis-admin.git/hooks/post-update
从S1上clone出gitosis-admin仓库到C1:
/home/chenshu/my_git
cd ~/my_git
git clone git@S1:gitosis-admin.git
Cloning into gitosis-admin...
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 1), reused 5 (delta 1)
Receiving objects: 100% (5/5), done.
Resolving deltas: 100% (1/1), done.
现在你可以通过修改gitosis-admin/gitosis.conf文件来远程管理S1上的仓库:
[gitosis]
[group gitosis-admin]
members = chenshu@chenshu-System-Product-Name
writable = gitosis-admin
上面是之前gitosis初始化导入C1的公钥的时候自动创建的，已经将C1的用户加入到管理员成员中
注意：也可以就在服务器端完成本节操作，不一定非要到客户端。
5.加入新用户
现在另一台Ubuntu客户端C2，用户也想加入进来使用cml项目，并管理git仓库。
C2机器的使用者在C2上产生公钥和私钥文件，并将公钥文件传给C1的使用者（因为C1的使用者现在是管理员）
~/my_git/gitosis-admin$ mv ~/id_rsa.pub ./keydir/[email protected]
上面的命令是在C1上把C2产生的公钥文件id_rsa.pub复制到/home/chenshu/my_git/gitosis-admin/keydir目录下，并改名为[email protected]
文件名是根据id_rsa.pub里面的用户名来的。
[group gitosis-admin]
members = chenshu@chenshu-System-Product-Name [email protected]
writable = gitosis-admin
修改gitosis.conf文件，加入[email protected](去掉.pub后缀)到gitosis-admin组，也就是[email protected]成了管理员
在gitoosis-admin目录下，提交设置到服务端：
git add .
git commit -am'add a new user'
git push
现在到C2上试一下：
git clone git@S1:gitosis-admin.git
ok,成功获得该目录。
6.创建新项目
仍然编辑C1上的gitsosis.conf文件，加入
[group cml]
members = chenshu@chenshu-System-Product-Name [email protected]
writable = cml
[group cml] 一节 代表新的组（项目cml),也将C1,C2的用户加入进来.先提交一下配置文件。
git add .
git commit -am'add a new project named cml'
git push
然后再添加真实的项目文件。在顶层目录，我这里是/home/chenshu/my_git/下面创建项目目录cml,将需要的项目文件复制到cml中，然后执行下面的命令，将cml项目加入到S1中：
cd cml
git init //cml中会创建一个.git，里面包含了git版本库的框架
touch x
git add .
git remote add origin git@S1:cml.git //可以在git add . 之前运行
git commit -am 'add cml project'
git push origin master:refs/heads/master
7.获得cml项目
在C1或者C2机器上任何一个目录下，执行
git clone git@S1:cml.git
就可以获得刚才加入到S1上的cml项目。
8.编写脚本自动编译并部署时的注意
如果想在C2上编写脚本自动从S1上获取最新代码时，要注意：
1.首先之前产生的公钥不能设密码，否则每次git pull的时候都会要求输入密码。
2.不要将项目中的编译中间文件提交到S1上，比如CMake工程里面的build目录的文件，Maven工程里面的target目录里面的文件。否则下次在C2等客户端用git pull会报类似于这样的错误：
error: Untracked working tree file 'public/images/icon.gif' would be overwritten by merge.
需要执行下面的命令才能修复：
git reset --hard HEAD
git clean -f -d
git pull
9.小心脑残的设计
linus这个设计的确很脑残，当从工作目录下删除了一个文件，然后试图从服务器上拿回来的时候，
git pull 总是说 up to date。骗我两小时。用下面的命令就好：
git ls-files --deleted | xargs git checkout
10.改变默认端口
默认使用的是SSH22端口，也就是Git连接远程服务器的22端口。如果服务器改变了端口号，比如443怎么办？
在你的当前工程根目录下，有一个.git目录，打开里面的config文件，在[remote "origin"] 一节将url修改一下：
url = ssh://git@S1:443/cml.git
#url = git@S1:cml.git
如果还没有工程，需要clone一份，用下面的命令：
git clone ssh://git@S1:443/cml.git
11.Git add违反直觉的多用途
最简单的用法，将一个未被tracked的文件加入到Git中；
比较莫名的是，如果一个已经被tracked的文件被修改了，必须再add一次，才能使得它的状态变为staged，也就是在staged area中记录下来它被修改了，否则接下来的commit操作直接忽视它；。因此在commit之前，用git status来确认所有修改的文件都已经在staged area中很有必要。真的繁琐，其实有时候需要一个快捷命令一次搞定，可以在commit的时候加上-a参数即可。将会自动在commit之前运行add命令。
居然还可以用add标记文件冲突已经解决。
11.Agent admitted failure to sign using the key
遇到一个很奇怪的问题，添加一个用户的时候一切步骤都是正确的，就是一直要求输入密码。当然有个报错信息：
Agent admitted failure to sign using the key
原来需要在客户端导入私钥，用下面的命令：
ssh-add ~/.ssh/id_rsa
原因不明，现在对SSH认证机制的原理还不够清楚，以后慢慢弄明白吧。
12.直接从本地仓库中clone
在Ubuntu下，按照以上的操作完成服务器搭建后，默认git文件会存放在/home/git/repositories目录下。用下面的命令直接clone即可。
git clone /home/git/repositories/cml.git
于是想到了在手上已有的服务器上安装搭建一个git服务器作为自己的代码管理中心。
废话少说，
另外，这个日志也还不错[url]http://blog.csdn.net/ice520301/article/details/6142503[/url]
感谢这几篇文章的作者：
[url]http://www.hackido.com/2010/01/installing-git-on-server-ubuntu-or.html[/url]
同时参考一下：
[url]http://www.debuntu.org/ssh-key-based-authentication[/url] 这篇文章介绍了SSH公钥和私钥的生成方法。
这篇文章里面介绍了新加用户的部分补充了第一篇文章的不足。
[url]http://www.jiangmiao.org/blog/1600.html[/url]
这篇文章介绍了ssh-keygen命令的参数
[url]http://lamp.linux.gov.cn/OpenSSH/ssh-keygen.html[/url]
我的安装步骤主要来源于上面引用的第一篇文章，并补充不足之处（比如原文第6条作者没说清楚）。
注意，Git是分布式管理工具，因此没有真正的Server，本文用了三台机器，分别是
S1 代表 机房里面的Ubuntu 11.10 server
C1 代表 第一台拥有管理权限的 Ubuntu desktop
C2 代表 后来被添加进来的拥有管理权限的Ubuntu desktop
三台机器都可以看作是服务器。只是从方便人使用的角度，总是将项目文件提交到S1上，并从S1上获得最新项目文件。
1.Ubuntu server安装Git服务程序
下文称这台Ubuntu server为S1
sudo apt-get install git-core
2.S1上安装Gitosis程序.
Gitosis是一个工具程序，可以帮助我们进行Git仓库的访问控制和远程管理。
sudo apt-get install python-setuptools
mkdir ~/src
cd ~/src
git clone https://github.com/res0nat0r/gitosis.git
cd gitosis
sudo python setup.py install
3.S1上创建一个git帐号。
没有密码。这个帐号是给Gitosis程序使用的。
sudo adduser \
--system \
--shell /bin/sh \
--gecos 'git version control' \
--group \
--disabled-password \
--home /home/git \
git
4.安装远程管理客户端
下文将第一个远程管理客户端称为C1
sudo apt-get install openssh-client
ssh-keygen
如果没有安装openssh-client，才需要第一行命令。ssh-keygen命令会创建公钥和私钥文件。将公钥文件复制到服务端。然后在S1上导入到Gitosis中以后C1就无需用户名和密码便能通过SSH连接服务端了。
scp /home/chenshu/.ssh/id_rsa.pub cncm@S1:/home/cncm
sudo -H -u git gitosis-init < /home/cncm/id_rsa.pub
得到下面的结果：
Initialized empty Git repository in /home/git/repositories/gitosis-admin.git/
Reinitialized existing Git repository in /home/git/repositories/gitosis-admin.git/
意思是S1上已经成功创建了仓库目录，路径是/home/git/repositories，并且里面还创建了一个管理员仓库，叫gitosis-admin。
修改S1上一个文件的权限：
sudo chmod 755 /home/git/repositories/gitosis-admin.git/hooks/post-update
从S1上clone出gitosis-admin仓库到C1:
/home/chenshu/my_git
cd ~/my_git
git clone git@S1:gitosis-admin.git
Cloning into gitosis-admin...
remote: Counting objects: 5, done.
remote: Compressing objects: 100% (4/4), done.
remote: Total 5 (delta 1), reused 5 (delta 1)
Receiving objects: 100% (5/5), done.
Resolving deltas: 100% (1/1), done.
现在你可以通过修改gitosis-admin/gitosis.conf文件来远程管理S1上的仓库:
[gitosis]
[group gitosis-admin]
members = chenshu@chenshu-System-Product-Name
writable = gitosis-admin
上面是之前gitosis初始化导入C1的公钥的时候自动创建的，已经将C1的用户加入到管理员成员中
注意：也可以就在服务器端完成本节操作，不一定非要到客户端。
5.加入新用户
现在另一台Ubuntu客户端C2，用户也想加入进来使用cml项目，并管理git仓库。
C2机器的使用者在C2上产生公钥和私钥文件，并将公钥文件传给C1的使用者（因为C1的使用者现在是管理员）
~/my_git/gitosis-admin$ mv ~/id_rsa.pub ./keydir/[email protected]
上面的命令是在C1上把C2产生的公钥文件id_rsa.pub复制到/home/chenshu/my_git/gitosis-admin/keydir目录下，并改名为[email protected]
文件名是根据id_rsa.pub里面的用户名来的。
[group gitosis-admin]
members = chenshu@chenshu-System-Product-Name [email protected]
writable = gitosis-admin
修改gitosis.conf文件，加入[email protected](去掉.pub后缀)到gitosis-admin组，也就是[email protected]成了管理员
在gitoosis-admin目录下，提交设置到服务端：
git add .
git commit -am'add a new user'
git push
现在到C2上试一下：
git clone git@S1:gitosis-admin.git
ok,成功获得该目录。
6.创建新项目
仍然编辑C1上的gitsosis.conf文件，加入
[group cml]
members = chenshu@chenshu-System-Product-Name [email protected]
writable = cml
[group cml] 一节 代表新的组（项目cml),也将C1,C2的用户加入进来.先提交一下配置文件。
git add .
git commit -am'add a new project named cml'
git push
然后再添加真实的项目文件。在顶层目录，我这里是/home/chenshu/my_git/下面创建项目目录cml,将需要的项目文件复制到cml中，然后执行下面的命令，将cml项目加入到S1中：
cd cml
git init //cml中会创建一个.git，里面包含了git版本库的框架
touch x
git add .
git remote add origin git@S1:cml.git //可以在git add . 之前运行
git commit -am 'add cml project'
git push origin master:refs/heads/master
7.获得cml项目
在C1或者C2机器上任何一个目录下，执行
git clone git@S1:cml.git
就可以获得刚才加入到S1上的cml项目。
8.编写脚本自动编译并部署时的注意
如果想在C2上编写脚本自动从S1上获取最新代码时，要注意：
1.首先之前产生的公钥不能设密码，否则每次git pull的时候都会要求输入密码。
2.不要将项目中的编译中间文件提交到S1上，比如CMake工程里面的build目录的文件，Maven工程里面的target目录里面的文件。否则下次在C2等客户端用git pull会报类似于这样的错误：
error: Untracked working tree file 'public/images/icon.gif' would be overwritten by merge.
需要执行下面的命令才能修复：
git reset --hard HEAD
git clean -f -d
git pull
9.小心脑残的设计
linus这个设计的确很脑残，当从工作目录下删除了一个文件，然后试图从服务器上拿回来的时候，
git pull 总是说 up to date。骗我两小时。用下面的命令就好：
git ls-files --deleted | xargs git checkout
10.改变默认端口
默认使用的是SSH22端口，也就是Git连接远程服务器的22端口。如果服务器改变了端口号，比如443怎么办？
在你的当前工程根目录下，有一个.git目录，打开里面的config文件，在[remote "origin"] 一节将url修改一下：
url = ssh://git@S1:443/cml.git
#url = git@S1:cml.git
如果还没有工程，需要clone一份，用下面的命令：
git clone ssh://git@S1:443/cml.git
11.Git add违反直觉的多用途
最简单的用法，将一个未被tracked的文件加入到Git中；
比较莫名的是，如果一个已经被tracked的文件被修改了，必须再add一次，才能使得它的状态变为staged，也就是在staged area中记录下来它被修改了，否则接下来的commit操作直接忽视它；。因此在commit之前，用git status来确认所有修改的文件都已经在staged area中很有必要。真的繁琐，其实有时候需要一个快捷命令一次搞定，可以在commit的时候加上-a参数即可。将会自动在commit之前运行add命令。
居然还可以用add标记文件冲突已经解决。
11.Agent admitted failure to sign using the key
遇到一个很奇怪的问题，添加一个用户的时候一切步骤都是正确的，就是一直要求输入密码。当然有个报错信息：
Agent admitted failure to sign using the key
原来需要在客户端导入私钥，用下面的命令：
ssh-add ~/.ssh/id_rsa
原因不明，现在对SSH认证机制的原理还不够清楚，以后慢慢弄明白吧。
12.直接从本地仓库中clone
在Ubuntu下，按照以上的操作完成服务器搭建后，默认git文件会存放在/home/git/repositories目录下。用下面的命令直接clone即可。
git clone /home/git/repositories/cml.git