linux 安装 git server

chunjihong

　　一 安装
　　版本控制系统经历 CVS ， SVN， 现在到了 Git 的世界。 Git 与 CVS， SVN 相比有很多的优势，其中最为人津津乐道的就是 branch 的切换都是在本地执行，速度非常之快，非常利于分布式开发进程。现在也是开源世界了最流行的版本控制系统。比如：Fedora 社区（http://git.fedorahosted.org/git）， JBoss AS 7 的 source（https://github.com/jbossas/jboss-as） 等。
　　GitHub 提供免费的 Git server， 但是它仅仅针对 Public 的 repository 是免费的，如果你想有你个人的 Git repsotories， 就需要交费了。 但是， 依照国人一向不信他人，只信自己的美德， 应该很少有人把机密的代码交由外人掌管吧，万一 GitHub 被黑了， 那岂不是一起遭殃？ 怎么办呢， 自己建立个 Server 不就完了吗。

第一步： 安装 Git

NOTE：
接下来的操作都是在 Server 机器上运行　　Fedora 下运行：

Shell代码  

• yum install git-core
  

　　Ubuntu 下运行：

Shell代码  

• apt-get install git-core
  

第二步： 初始化一个 repository

Shell代码  

• [lgao@lgao myclone]$ cd /home/lgao/sources/my_own/repositories/
  
• [lgao@lgao repositories]$ git init --bare myprj
  
• Initialized empty Git repository in /home/lgao/sources/my_own/repositories/myprj/.git/
  

　　指定 --bare，当前 repository 下就只有 .git/ 下的 objects，而没有真实文件。一般在 Server 端。

第三步： 初始化提交
　　当一个 repository 初始化后， 里面什么也没有。我们需要建立个 master branch，才能被正常 clone 到其他地方。

Shell代码  

• [lgao@lgao myclient]$ mkdir initial.commit
  
• [lgao@lgao myclient]$ cd initial.commit/
  
• [lgao@lgao initial.commit]$ git init
  
• Initialized empty Git repository in /home/lgao/sources/my_own/myclient/initial.commit/.git/
  
• [lgao@lgao initial.commit]$ git remote add origin /home/lgao/sources/my_own/repositories/myprj/
  
• [lgao@lgao initial.commit]$ touch Readme
  
• [lgao@lgao initial.commit]$ git add Readme
  
• [lgao@lgao initial.commit]$ git commit -m "initial commit"
  
• [master (root-commit) 032dad8] initial commit
  
• 0 files changed, 0 insertions(+), 0 deletions(-)
  
• create mode 100644 Readme
  
• [lgao@lgao initial.commit]$ git push origin master
  
• Counting objects: 3, done.
  
• Writing objects: 100% (3/3), 206 bytes, done.
  
• Total 3 (delta 0), reused 0 (delta 0)
  
• Unpacking objects: 100% (3/3), done.
  
• To /home/lgao/sources/my_own/repositories/myprj/
  
• * [new branch]      master -> master
  

第四步  正常使用
　　经过初始化提交过程，相当于激活了该 repository, 我们可以正常使用了。

Shell代码  

• [lgao@lgao myclient]$ git clone /home/lgao/sources/my_own/repositories/myprj/
  
• Cloning into 'myprj'...
  
• done.
  
• [lgao@lgao myclient]$ cd myprj
  
• [lgao@lgao myprj]$ l
  
• total 0
  
• -rw-rw-r-- 1 lgao lgao 0 Jan 21 15:15 Readme
  
• [lgao@lgao myprj]$ vim Readme
  
• [lgao@lgao myprj]$ git commit -m "modify readme" Readme
  
• [master 1bf69b4] modify readme
  
• 1 files changed, 1 insertions(+), 0 deletions(-)
  
• [lgao@lgao myprj]$ git push
  
• Counting objects: 5, done.
  
• Writing objects: 100% (3/3), 247 bytes, done.
  
• Total 3 (delta 0), reused 0 (delta 0)
  
• Unpacking objects: 100% (3/3), done.
  
• To /home/lgao/sources/my_own/repositories/myprj/
  
•    032dad8..1bf69b4  master -> master
  

第五步   与他人共享 Repository
　　按照上面的步骤，我们已经可以使用 Git 了。 但是 Git repository 的 URL 都是本地目录， 怎么能方便的让合作伙伴方便的访问该 Repository 呢？ 这就要介绍下 Git 支持的 4 中传输协议了： Local， SSH， Git， HTTP。 我们一个个的介绍：

Local
　　Local 就是指本地文件系统，可以是本机器文件，也可以是通过 NFS 加载的网络映射。这种情形下与人共享就是把你的 repository 所在的目录作为 NFS 共享出去，让能访问到你机器的人像本地文件一样操作。具体怎么 NFS 共享超出本文范围，不加讨论（有兴趣的请参考： http://docs.fedoraproject.org/en-US/Fedora/14/html/Storage_Administration_Guide/ch-nfs.html ）。不过不推荐这种方式共享， 因为效率太低。

SSH
　　SSH 协议大家都很熟悉，只要你的 Server 能 ssh 登录就可以。假设你的 Server 可以远程 ssh 登录，我们看如何从 Server clone 出 Git Repository：

Shell代码  

• [lgao@lgao myclient]$ git clone lgao@10.66.14.143:git_repos/myprj from_remote
  
• Cloning into 'from_remote'...
  
• lgao@10.66.14.143's password:
  
• remote: Counting objects: 3, done.
  
• remote: Total 3 (delta 0), reused 0 (delta 0)
  
• Receiving objects: 100% (3/3), done.
  

  也就是说只要你在 Server 端给一个用户创建完帐号后， 他就可以 clone 代码了。 具体的权限设置和 Linux 下权限配置是一样的。 一般跟一组 repositories 指定一个新的 group， 把新建的用户加入到该 group 后就可以有相应的读写权限了。

   还有另外一种方式，是通过提交公钥到 Server 端来获得访问和提交权限，而不需要创建用户。 具体细节本文不加讨论。

Git
　　该协议一般只是只读权限。
　　第一步需要安装 git-daemon：

Shell代码  

• [iyunv@lgao ~]# yum install git-daemon
  

　　接着启动 git-daemon：

Shell代码  

• [lgao@lgao initial.commit]$ git daemon --base-path=/home/lgao/sources/my_own/repositories --export-all
  

　　在你的工程下创建 git-daemon-export-ok 文件：

Shell代码  

• [lgao@lgao repositories]$ cd myprj
  
• [lgao@lgao myprj]$ touch git-daemon-export-ok
  

　　现在就可以通过 Git 协议 clone repository 了：

Shell代码  

• [lgao@lgao test]$ git clone git://lgao.nay.redhat.com/myprj
  
• Cloning into 'myprj'...
  
• remote: Counting objects: 6, done.
  
• remote: Compressing objects: 100% (2/2), done.
  
• remote: Total 6 (delta 0), reused 0 (delta 0)
  
• Receiving objects: 100% (6/6), done.
  

HTTP
　　该协议一般只是只读权限。GitWeb 包提供 CGI ， 它可以被部署到任何支持静态 web 服务的服务器中去。我们还以最常见的 Apache 为例：
　　版本信息：

Shell代码  

• Httpd：Apache/2.2.21 (Fedora)
  
• Git：  git version 1.7.7.5
  
• GitWeb：1.7.7.5-1.fc16
  

　　安装 Httpd 和 gitweb：

Shell代码  

• [lgao@lgao initial.commit]$ sudo yum install httpd gitweb
  

　　修改 /etc/gitweb.conf：

Shell代码  

• [lgao@lgao repositories]$ vim /etc/gitweb.conf
  
• 修改：
  
• our $projectroot = "/home/lgao/sources/my_own/repositories";
  

　　在 httpd 的 DocumentRoot 所在目录创建 Link 文件：

Shell代码  

• [iyunv@lgao DCIM]# cd /var/www/html
  
• [iyunv@lgao html]# ln -s /home/lgao/sources/my_own/repositories/ git
  
• [iyunv@lgao html]# chown -R lgao.lgao git
  

　　修改 httpd.conf 中的 user 和 group：

Java代码  

• User lgao
  
• Group lgao
  

　　重启 httpd：

Shell代码  

• [iyunv@lgao httpd]# service httpd restart
  
• Restarting httpd (via systemctl):                          [  OK  ]
  

　　OK 了， 现在就可以访问了：

　　你可以修改 Server 机器下 <Your Repo>/description ，这样可以显示在 git web 页面上。
　　修改 <Your Repo>/config ， 加上 owner 和 url：

Shell代码  

• [gitweb]
  
•         owner = Your Name <name@example.com>
  
•         url = git://lgao.nay.redhat.com/myprj
  

　　之后，我们再看看截图：

　　二 git常用命令
　　git clone: 这是较为简单的一种初始化方式，当你已经有一个远程的Git版本库，只需要在本地克隆一份，例如'git clone git://github.com/someone/some_project.git some_project'命令就是将'git://github.com/someone/some_project.git'这个URL地址的远程版 本库完全克隆到本地some_project目录下面
　　git init和git remote：这种方式稍微复杂一些，当你本地创建了一个工作目录，你可以进入这个目录，使用'git init'命令进行初始化，Git以后就会对该目录下的文件进行版本控制，这时候如果你需要将它放到远程服务器上，可以在远程服务器上创建一个目录，并把 可访问的URL记录下来，此时你就可以利用'git remote add'命令来增加一个远程服务器端，例如'git remote add origin git://github.com/someone/another_project.git'这条命令就会增加URL地址为'git: //github.com/someone/another_project.git'，名称为origin的远程服务器，以后提交代码的时候只需要使用 originalias.html' target='_blank'>别名即可
　　现在我们有了本地和远程的版本库，让我们来试着用用Git的基本命令吧：
　　git pull：从其他的版本库（既可以是远程的也可以是本地的）将代码更新到本地，例如：'git pull origin master'就是将origin这个版本库的代码更新到本地的master主枝，该功能类似于SVN的update
　　git add：是将当前更改或者新增的文件加入到Git的索引中，加入到Git的索引中就表示记入了版本历史中，这也是提交之前所需要执行的一步，例如'git add app/model/user.rb'就会增加app/model/user.rb文件到Git的索引中
　　git rm：从当前的工作空间中和索引中删除文件，例如'git rm app/model/user.rb'
　　git commit：提交当前工作空间的修改内容，类似于SVN的commit命令，例如'git commit -m story #3, add user model'，提交的时候必须用-m来输入一条提交信息
　　git push：将本地commit的代码更新到远程版本库中，例如'git push origin'就会将本地的代码更新到名为orgin的远程版本库中
　　git log：查看历史日志
　　git revert：还原一个版本的修改，必须提供一个具体的Git版本号，例如'git revert bbaf6fb5060b4875b18ff9ff637ce118256d6f20'，Git的版本号都是生成的一个哈希值
　　上面的命令几乎都是每个版本控制工具所公有的，下面就开始尝试一下Git独有的一些命令：
　　git branch：对分支的增、删、查等操作，例如'git branch new_branch'会从当前的工作版本创建一个叫做new_branch的新分支，'git branch -D new_branch'就会强制删除叫做new_branch的分支，'git branch'就会列出本地所有的分支
　　git checkout：Git的checkout有两个作用，其一是在不同的branch之间进行切换，例如'git checkout new_branch'就会切换到new_branch的分支上去；另一个功能是还原代码的作用，例如'git checkout app/model/user.rb'就会将user.rb文件从上一个已提交的版本中更新回来，未提交的内容全部会回滚
　　git rebase：用下面两幅图解释会比较清楚一些，rebase命令执行后，实际上是将分支点从C移到了G，这样分支也就具有了从C到G的功能
　　git stash：将当前未提交的工作存入Git工作栈中，时机成熟的时候再应用回来，这里暂时提一下这个命令的用法，后面在技巧篇会重点讲解
　　git config：利用这个命令可以新增、更改Git的各种设置，例如'git config branch.master.remote origin'就将master的远程版本库设置为别名叫做origin版本库，后面在技巧篇会利用这个命令个性化设置你的Git，为你打造独一无二的 Git
　　git tag：可以将某个具体的版本打上一个标签，这样你就不需要记忆复杂的版本号哈希值了，例如你可以使用'git tag revert_version bbaf6fb5060b4875b18ff9ff637ce118256d6f20'来标记这个被你还原的版本，那么以后你想查看该版本时，就可以使用 revert_version标签名，而不是哈希值了

使用Gitolite来对Git的repository实现权限控制
　　我们项目组打算从svn向git迁移，前几天我搭建了git环境，把代码从svn转移过来，然后所有成员都通过server上的git账号来做pull和push，一切都安置妥当，没有问题。但是后来其它项目组也打算使用这个git server，那么问题来了，之前那种授权的方式肯定是不够的，因为只要能连上server，那么他对这个server上所有的repository都有完全的读写权限，这显然是不可接受的。
　　所以打算使用Gitolite这个组件来做权限控制，搜索了下，找到的文章貌似都是老版本的，所以有了写这篇文章的想法。
　　Gitolite其实也是一个git repository，首先在server上安装好后，在client上把server上的repository clone下来，在本地做一些更改，再push回server，server端的hooks会根据push上来的配置来更新权限。
　　接下来，介绍下安装和配置步骤

准备工作
　　如果你之前是用git账号来做权限控制的话，记得把/etc/passwd里git用户的shell换回/bin/bash，然后把~git/.ssh/authorized_key里不再需要的key移除。
　　用ssh-kengen生成一对key，比如your-name和your-name.pub（下文均以此为例）
　　拷贝私钥到本用户的.ssh文件夹中
　　

mv your-name ~/.ssh/　　

　　

　　拷贝公钥到git server上
　　

scp you-name.pub git@your.server.name.or.ip.address:~　　

　　

　　为了以后方便，这里可以做一个server别名，指定连接所需的用户名，server的地址、端口以及私钥
　　

vim ~/.ssh/config　　

　　

　　输入以下内容
　　

host githost　　
user your-name
　　
hostname your.server.name.or.ip.address
　　
port 22
　　
identityfile ~/.ssh/your-name
　　

　　


安装Gitolite
　　登录git server
　　

ssh git@your.server.name.or.ip.address　　

　　

　　下载最新的Gitolite
　　

git clone git://github.com/sitaramc/gitolite　　

　　

　　安装，这里说明下，安装方式有3种，区别在与指定生成gitolite可执行文件的路径，这里采用Gitolite作者推荐的第二种，也就是把文件生成到$HOME/bin中，这样可以在接下来的bash中直接执行gitolite命令而不用指定路径(如果你的~/bin目录不存在记得先mkdir ~/bin)
　　

gitolite/install -ln　　

　　

　　设置，由于是第一次运行这个命令，所以这里指定的key是拥有Gitolite管理员权限的
　　

gitolite setup -pk your-name.pub　　

　　

　　此命令会在你的~/repositories/目录生成两个repository：gitolite-admin.git和testing.git

配置权限
　　退到你的workstation上
　　

exit　　

　　

　　clone刚才生成的gitolite-admin.git
　　

git clone githost:gitolite-admin　　

　　

　　注意这里用的是刚才准备好的server别名来连接的，其中最重要的区别是使用your-name.pub这个key，并且没有采用绝对路径来指定想要clone的repository，而是直接使用名称，并且这个名称也没有包括.git这个后缀。这一点很重要，因为这是用Gitolite的机制来clone，如果你跳过它直接使用git来，那么它的一些功能就无法实现了。以后clone, push其它需要受Gitolite权限控制的repository都必须这样做。
　　clone完后会有个新的目录gitolite-admin，里面有两个文件夹conf和keydir，第一个目录中包含的是配置文件，里面就是记录权限配置的地方，第二个目录中则包含所有用户的pub key。
　　现在我们打开配置文件，按照我们的权限配置需要进行设置
　　

vim gitolite-admin/conf/gitolite.conf　　

　　

　　我期望的配置如下，你也可以根据你的需要做更改
　　

@repos_a @proj1 @proj2　　
@repos_b @proj3 @proj4 @proj5
　　

　　
@team_a @user1 @user2
　　
@team_b @user3 @user4
　　

　　
repo gitolite-admin
　　
RW+ = your-name
　　

　　
repo @repos_a
　　
RW+ = @team_a
　　
R = @all
　　

　　
repo @repos_b
　　
RW+ = @team_b
　　

　　

　　这个配置很简单，首先定义了两个repository group，再又定义了两个user group，group的好处就是以后添加repository和user的时候，不需要再单独配置，只需加入到对应的group中即可。

• 添加全新的repository，在上面提到的gitolite.conf文件中配置好对应的名称和权限，再push到server即可，server会自动帮你创建一个empty的bare repository。
  
• 如果你已经有一个repository，想把它加进来的话，那就把它拷贝到git server上的~/repositories文件夹里，记得文件夹名要以.git结尾，并且这个repository一定要是bare的，（你可以通过拷贝repository里的.git文件夹，然后运行git config --bool core.bare true，也可以运行git clone --bare your-repository来得到bare repository）。这种方式还有一个额外的操作就是在server上运行一次gitolite setup。
  
• 移除repository，在配置文件中移除对应的repo，然后push，接着再删除server上对应的文件夹即可。
  
• 添加user，把pub key拷贝到keydir文件夹里
  
• 删除user，一样，移除keydir里对应的pub key
  

　　注意，上面说的操作，都必须在clone的gitolite-admin里做更改，然后push，千万别在server上自己来，那样是没用的，因为这些权限配置、repository管理都有一些额外的操作，gitolite-admin会帮你搞定一切。
　　把你的更改push回server上，试试clone，pull，push，看看权限是否正确。比如
　　

git clone githost:proj3　　

　　

　　更多的内容，可以参考官方文档