git服务器配置与搭建

11-19 Git与Svn,Web开发 lx_myjishu 245,490 views

git服务器配置与搭建

11-19 245,490 views

公司开发前段时间连接github老是断线，需要自己搭建git服务器，只用过github，但是没有搭建过git服务器，Google了下相关资料，参考git官方文档搞起：
http://git-scm.com/book/zh/v1/%E8%B5%B7%E6%AD%A5

首先找了一台业务不多的服务器，然后按照文档学习了下基本操作，参考：
http://www.liaoxuefeng.com

首先安装git前安装相关的依赖包：

yum install curl-devel expat-devel gettext-devel openssl-devel zlib-devel –skip-broken

下载git源码包

wget ftp://ftp.be.debian.org/pub/software/scm/git/git-1.7.2.2.tar.gz

tar -zxf git-1.7.2.2.tar.gz

cd git-1.7.2.2

将解压的包放在固定目录下：

useradd lixiang

mkdir -p /home/lixiang/tools/

mv git-1.7.2.2 git-1.7.2.2.tar.gz /home/lixiang/tools/

cd /home/lixiang/tools/

安装git

cd git-1.7.2.2

make prefix=/usr/local all

安装报错，报错信息：

* tclsh failed; using unoptimized loading

MSGFMT po/de.msg make[1]: *** [po/de.msg] Error 127

解决方法：

yum install perl-CPAN

yum install gettext

继续安装，命令如下：

make prefix=/usr/local all

make prefix=/usr/local/ install

安装完成。

创建存放git目录:

mkdir /opt/gitdir

进入目录，初始化git

cd /opt/gitdir/

git init

Initialized empty Git repository in /opt/gitdir/.git/

[root@localhost gitdir]# ll -a

total 12

drwxr-xr-x 3 root root 4096 Nov 18 16:12 .

drwxr-xr-x. 3 root root 4096 Nov 18 16:11 ..

drwxr-xr-x 7 root root 4096 Nov 18 16:12 .git

创建readme.txt，将文件加入到git管理中

[root@localhost gitdir]# git add readme.txt

把文件提交到仓库:

[root@localhost gitdir]# git commit -m “wrote a readme file”

[master (root-commit) 5ca5fcf] wrote a readme file

Committer: root <root@localhost.localdomain>

Your name and email address were configured automatically based

on your username and hostname. Please check that they are accurate.

You can suppress this message by setting them explicitly:

git config –global user.name “Your Name”

git config –global user.email you@example.com

If the identity used for this commit is wrong, you can fix it with:

git commit –amend –author=’Your Name <you@example.com>’

1 files changed, 2 insertions(+), 0 deletions(-)

create mode 100644 readme.txt

简单解释一下git commit命令，-m后面输入的是本次提交的说明，可以输入任意内容，当然最好是有意义的，这样你就能从历史记录里方便地找到改动记录。

为什么Git添加文件需要add，commit一共两步呢？因为commit可以一次提交很多文件，所以你可以多次add不同的文件，比如：

[root@localhost gitdir]# touch file1.txt

[root@localhost gitdir]# touch file2.txt

[root@localhost gitdir]# touch file3.txt

[root@localhost gitdir]#

[root@localhost gitdir]# git add file1.txt

[root@localhost gitdir]# git add file2.txt

[root@localhost gitdir]# git add file3.txt

[root@localhost gitdir]# git commit -m “add 3 files.”

[master 01401bd] add 3 files.

Committer: root <root@localhost.localdomain>

Your name and email address were configured automatically based

on your username and hostname. Please check that they are accurate.

You can suppress this message by setting them explicitly:

git config –global user.name “Your Name”

git config –global user.email you@example.com

If the identity used for this commit is wrong, you can fix it with:

git commit –amend –author=’Your Name <you@example.com>’

0 files changed, 0 insertions(+), 0 deletions(-)

create mode 100644 file1.txt

create mode 100644 file2.txt

create mode 100644 file3.txt

初始化一个Git仓库，使用git init命令。

添加文件到Git仓库，分两步：

第一步，使用命令git add <file>，注意，可反复多次使用，添加多个文件；最后commit一次全部提交文件。
第二步，使用命令git commit，完成。

修改readme.txt文件，查看git状态，发现已经改变但是文件没有提交

[root@localhost gitdir]# git status

# On branch master

# Changed but not updated:

# (use “git add <file>…” to update what will be committed)

# (use “git checkout — <file>…” to discard changes in working directory)

# modified: readme.txt

no changes added to commit (use “git add” and/or “git commit -a”)

对比下更改了那些地方？

[root@localhost gitdir]# git diff readme.txt

diff –git a/readme.txt b/readme.txt

index 46d49bf..9247db6 100644

— a/readme.txt

+++ b/readme.txt

@@ -1,2 +1,2 @@

-Git is a version control system.

+Git is a distributed version control system.

Git is free software.

[root@localhost gitdir]# git add readme.txt

添加文件后，看看git状态：

[root@localhost gitdir]# git status

# On branch master

# Changes to be committed:

# (use “git reset HEAD <file>…” to unstage)

# modified: readme.txt

确认提交后，在看git状态：

root@localhost gitdir]# git commit -m “add distributed”

[master b39aa1c] add distributed

Committer: root <root@localhost.localdomain>

Your name and email address were configured automatically based

on your username and hostname. Please check that they are accurate.

You can suppress this message by setting them explicitly:

git config –global user.name “Your Name”

git config –global user.email you@example.com

If the identity used for this commit is wrong, you can fix it with:

git commit –amend –author=’Your Name <you@example.com>’

1 files changed, 1 insertions(+), 1 deletions(-)

[root@localhost gitdir]#

[root@localhost gitdir]# git status

# On branch master

nothing to commit (working directory clean)

再次修改readme.txt文件

[root@localhost gitdir]# vim readme.txt

[root@localhost gitdir]# git add readme.txt

[root@localhost gitdir]# git commit -m “append GPL”

[master d100483] append GPL

Committer: root <root@localhost.localdomain>

Your name and email address were configured automatically based

on your username and hostname. Please check that they are accurate.

You can suppress this message by setting them explicitly:

git config –global user.name “Your Name”

git config –global user.email you@example.com

If the identity used for this commit is wrong, you can fix it with:

git commit –amend –author=’Your Name <you@example.com>’

1 files changed, 1 insertions(+), 1 deletions(-)

查看git提交的记录：

[root@localhost gitdir]# git log

commit d100483a85857b34afcaed2de0bd06a4546c14e5

Author: root <root@localhost.localdomain>

Date: Tue Nov 18 16:35:19 2014 +0800

append GPL

commit b39aa1c1b7ab807fb9ea25d49a972fded3a2da4b

Author: root <root@localhost.localdomain>

Date: Tue Nov 18 16:30:29 2014 +0800

add distributed

commit 01401bd29ad635e1f60c0530105a5a0669b344f3

Author: root <root@localhost.localdomain>

Date: Tue Nov 18 16:27:51 2014 +0800

add 3 files.

commit 5ca5fcfda3fc4efe4d1be16bfa063af2a4ca860d

Author: root <root@localhost.localdomain>

Date: Tue Nov 18 16:25:23 2014 +0800

wrote a readme file

只显示一行：

[root@localhost gitdir]# git log –pretty=oneline

d100483a85857b34afcaed2de0bd06a4546c14e5 append GPL

b39aa1c1b7ab807fb9ea25d49a972fded3a2da4b add distributed

01401bd29ad635e1f60c0530105a5a0669b344f3 add 3 files.

5ca5fcfda3fc4efe4d1be16bfa063af2a4ca860d wrote a readme file

回退到前一个版本：

[root@localhost gitdir]# git reset –hard HEAD^

HEAD is now at b39aa1c add distributed

[root@localhost gitdir]# cat readme.txt

Git is a distributed version control system.

Git is free software.

查看log

[root@localhost gitdir]# git log

commit b39aa1c1b7ab807fb9ea25d49a972fded3a2da4b

Author: root <root@localhost.localdomain>

Date: Tue Nov 18 16:30:29 2014 +0800

add distributed

commit 01401bd29ad635e1f60c0530105a5a0669b344f3

Author: root <root@localhost.localdomain>

Date: Tue Nov 18 16:27:51 2014 +0800

add 3 files.

commit 5ca5fcfda3fc4efe4d1be16bfa063af2a4ca860d

Author: root <root@localhost.localdomain>

Date: Tue Nov 18 16:25:23 2014 +0800

wrote a readme file

回退回来了，但是现在又想回到未来的那个版本，怎么办？

[root@localhost gitdir]# git reset –hard d100483a85857b34afcaed2de0bd06a4546c14e5

HEAD is now at d100483 append GPL

[root@localhost gitdir]# cat readme.txt

Git is a distributed version control system.

Git is free software distributed under the GPL.

这样就回退回来了，但是不记得commmit-id怎么办？

[root@localhost gitdir]# git reflog

d100483 HEAD@{0}: d100483a85857b34afcaed2de0bd06a4546c14e5: updating HEAD

b39aa1c HEAD@{1}: HEAD^: updating HEAD

d100483 HEAD@{2}: commit: append GPL

b39aa1c HEAD@{3}: commit: add distributed

01401bd HEAD@{4}: commit: add 3 files.

5ca5fcf HEAD@{5}: commit (initial): wrote a readme file

这样就可以看到所有commit-id了，想回退或回到未来都可以。

Git里面有个HEAD指针，

当你回退版本的时候，Git仅仅是把HEAD从指向“append GPL”：

在Git中，用HEAD表示当前版本，也就是最新的提交3628164…882e1e0（注意我的提交ID和你的肯定不一样），上一个版本就是HEAD^，上上一个版本就是HEAD^^，当然往上100个版本写100个^比较容易数不过来，所以写成HEAD~100。

进行了上面的简单学习和操作后开始配置git server

总共五步：

第一步，安装git：

$ sudo apt-get install git

第二步，创建一个git用户，用来运行git服务：

$ sudo adduser git

第三步，创建证书登录：

收集所有需要登录的用户的公钥，就是他们自己的id_rsa.pub文件，把所有公钥导入到/home/git/.ssh/authorized_keys文件里，一行一个。

第四步，初始化Git仓库：

先选定一个目录作为Git仓库，假定是/srv/sample.git，在/srv目录下输入命令：

$ sudo git init –bare sample.git

Git就会创建一个裸仓库，裸仓库没有工作区，因为服务器上的Git仓库纯粹是为了共享，所以不让用户直接登录到服务器上去改工作区，并且服务器上的Git仓库通常都以.git结尾。然后，把owner改为git：

$ sudo chown -R git:git sample.git

第五步，禁用shell登录：

出于安全考虑，第二步创建的git用户不允许登录shell，这可以通过编辑/etc/passwd文件完成。找到类似下面的一行：

git:x:1001:1001:,,,:/home/git:/bin/bash

改为：

git:x:1001:1001:,,,:/home/git:/usr/bin/git-shell

这样，git用户可以正常通过ssh使用git，但无法登录shell，因为我们为git用户指定的git-shell每次一登录就自动退出。

第六步，克隆远程仓库：

现在，可以通过git clone命令克隆远程仓库了，在各自的电脑上运行：

$ git clone git@server:/srv/sample.git

Cloning into ‘sample’…

warning: You appear to have cloned an empty repository.

剩下的推送就简单了。

创建ssh连接：

在client端执行：ssh-keygen -t rsa 一路回车，然后在家目录下面会创建一个.ssh里面会产生如下文件：
[git@localhost .ssh]$ ls
id_rsa id_rsa.pub known_hosts sample
将scp id_rsa.pub git@gitserver:~/.ssh/
到gitserver修改id_rsa.pub
cat id_rsa.pub > authorized_keys
然后修改gitserver .ssh目录的相关权限
chown git:git -R .ssh
chmod 700 -R .ssh

测试client 直接切换到git用户
su – git
[git@localhost ~]$ ssh git@gitserver
fatal: What do you think I am? A shell?
Connection to 115.238.101.156 closed.
这个是由于在gitserver将git用户登录家目录改为：
git:x:504:504::/home/git:/usr/local/bin/git-shell
如果是/bin/bash 那么可以正常登录成功，修改家目录是为了防止用git用户直接ssh登录服务器。
[root@localhost gitweb]# which git-shell
/usr/local/bin/git-shell

到此为止免key ssh登录做好了，可以直接读取gitserver的git库了.
su – git
[git@localhost ~]$ git clone git@gitserver:/srv/sample.git
Initialized empty Git repository in /home/git/sample/.git/
warning: You appear to have cloned an empty repository.
这样就说明git搭建正常.

这个时候可以把用户的公钥都加进来，这样所有的开发用户就可以clone下来gitserver的代码了，这种方法需要每一个用户建立一个用户名，然后需要将用户生成的公钥保存到gitserver上面，很麻烦，这个里面介绍了git几种连接方式的优缺点:
http://blog.jobbole.com/25944/

ssh这种方法很明显无法实现匿名访问，如果是开源的项目，想要实现匿名读取怎么办？
这个时候就需要借助Apache了，git的公共访问搭建：

或许对小型的配置来说最简单的办法就是运行一个静态 web 服务，把它的根目录设定为 Git 仓库所在的位置，然后开启本章第一节提到的 post-update 挂钩。这里继续使用之前的例子。假设仓库处于/opt/git 目录，主机上运行着 Apache 服务。重申一下，任何 web 服务程序都可以达到相同效果；作为范例，我们将用一些基本的 Apache 设定来展示大体需要的步骤。

首先，开启挂钩：

$ cd project.git
$ mv hooks/post-update.sample hooks/post-update
$ chmod a+x hooks/post-update

post-update 挂钩是做什么的呢？其内容大致如下：

$ cat .git/hooks/post-update
#!/bin/sh
#
# An example hook script to prepare a packed repository for use over
# dumb transports.
#
# To enable this hook, rename this file to "post-update".
#

exec git-update-server-info

意思是当通过 SSH 向服务器推送时，Git 将运行这个 git-update-server-info 命令来更新匿名 HTTP 访问获取数据时所需要的文件。

接下来，在 Apache 配置文件中添加一个 VirtualHost 条目，把文档根目录设为 Git 项目所在的根目录。这里我们假定 DNS 服务已经配置好，会把对 .gitserver 的请求发送到这台主机：

<VirtualHost *:80>
    ServerName git.gitserver
    DocumentRoot "/opt/git"
    <Directory "/opt/git/">
        Order allow,deny
        allow from all
    </Directory>
</VirtualHost>

另外，需要把 /opt/git 目录的 Unix 用户组设定为 www-data ，这样 web 服务才可以读取仓库内容，因为运行 CGI 脚本的 Apache 实例进程默认就是以该用户的身份起来的：

$ groupadd www-data
$ chgrp -R www-data /opt/git

重启 Apache 之后，就可以通过项目的 URL 来克隆该目录下的仓库了。

$ git clone http://git.gitserver/project.git

这一招可以让你在几分钟内为相当数量的用户架设好基于 HTTP 的读取权限。另一个提供非授权访问的简单方法是开启一个 Git 守护进程，不过这将要求该进程作为后台进程常驻 — 接下来的这一节就要讨论这方面的细节。

安装Apache可能会出现的问题：

#./configure –prefix……检查编辑环境时出现：

checking for APR… no
configure: error: APR not found . Please read the documentation

解决办法：

1.下载所需软件包：

1. wget http://archive.apache.org/dist/apr/apr-1.4.5.tar.gz

2. wget http://archive.apache.org/dist/apr/apr-util-1.3.12.tar.gz

3. wget http://jaist.dl.sourceforge.net/project/pcre/pcre/8.10/pcre-8.10.zip

2.编译安装：

1. yum remove apr-util-devel apr apr-util-mysql apr-docs apr-devel apr-util apr-util-docs

具体步骤如下:

a:解决apr not found问题>>>>>>

1. [root@xt test]# tar -zxf apr-1.4.5.tar.gz

2. [root@xt test]# cd apr-1.4.5

3. [root@xt apr-1.4.5]# ./configure –prefix=/usr/local/apr

4. [root@xt apr-1.4.5]# make && make install

b:解决APR-util not found问题>>>>

1. [root@xt test]# tar -zxf apr-util-1.3.12.tar.gz

2. [root@xt test]# cd apr-util-1.3.12

3. [root@xt apr-util-1.3.12]# ./configure –prefix=/usr/local/apr-util -with- apr=/usr/local/apr/bin/apr-1-config

4. [root@xt apr-util-1.3.12]# make && make install

c:解决pcre问题>>>>>>>>>

1. [root@xt test]#unzip -o pcre-8.10.zip

2. [root@xt test]#cd pcre-8.10

3. [root@xt pcre-8.10]#./configure –prefix=/usr/local/pcre

4. [root@xt pcre-8.10]#make && make install

4.最后编译Apache时加上：

–with-apr=/usr/local/apr \

–with-apr-util=/usr/local/apr-util/ \

–with-pcre=/usr/local/pcre

成功编译完成~

编译好Apache后进入配置文件，基于域名的虚拟主机配置，关于Apache配置文件，需要注意：
主配置文件http.conf：
ServerName localhost:80
###<Directory />
### AllowOverride none
### Require all denied
###</Directory>
其他的不用修改，修改成你虚拟主机的第一个配置也可以，因为后面虚拟主机的配置文件会覆盖掉前面的配置，当配置完成，开启Apache服务后，访问发现显示根目录拒绝访问，将主配置文件中的DocumentRoot改为跟虚拟主机一样，虚拟主机中配置文件
<VirtualHost *:80>
ServerAdmin root@localhost.com
DocumentRoot “/xx”
ServerName git.yuu1.com
# ServerAlias www.dummy-host.example.com
<Directory “/xx”>
Order allow,deny
allow from all
</Directory>

这样能够基本的访问了，测试命令：
git clone http://git.xxxx.com/sample.git

开始安装gitweb

现在我们的项目已经有了可读可写和只读的连接方式，不过如果能有一个简单的 web 界面访问就更好了。Git 自带一个叫做 GitWeb 的 CGI 脚本，运行效果可以到 http://git.kernel.org 这样的站点体验下（见图 4-1）。

Figure 4-1. 基于网页的 GitWeb 用户界面

如果想看看自己项目的效果，不妨用 Git 自带的一个命令，可以使用类似 lighttpd 或 webrick 这样轻量级的服务器启动一个临时进程。如果是在 Linux 主机上，通常都预装了 lighttpd ，可以到项目目录中键入 git instaweb 来启动。如果用的是 Mac ，Leopard 预装了 Ruby，所以 webrick 应该是最好的选择。如果要用 lighttpd 以外的程序来启动 git instaweb，可以通过 --httpd 选项指定：

$ git instaweb --httpd=webrick
[2009-02-21 10:02:21] INFO  WEBrick 1.3.1
[2009-02-21 10:02:21] INFO  ruby 1.8.6 (2008-03-03) [universal-darwin9.0]

这会在 1234 端口开启一个 HTTPD 服务，随之在浏览器中显示该页，十分简单。关闭服务时，只需在原来的命令后面加上 --stop 选项就可以了：

$ git instaweb --httpd=webrick --stop

如果需要为团队或者某个开源项目长期运行 GitWeb，那么 CGI 脚本就要由正常的网页服务来运行。一些 Linux 发行版可以通过 apt 或 yum 安装一个叫做 gitweb 的软件包，不妨首先尝试一下。我们将快速介绍一下手动安装 GitWeb 的流程。首先，你需要 Git 的源码，其中带有 GitWeb，并能生成定制的 CGI 脚本：

$ git clone git://git.kernel.org/pub/scm/git/git.git
$ cd git/
$ make GITWEB_PROJECTROOT="/opt/git" \
        prefix=/usr gitweb
$ sudo cp -Rf gitweb /var/www/

注意，通过指定 GITWEB_PROJECTROOT 变量告诉编译命令 Git 仓库的位置。然后，设置 Apache 以 CGI 方式运行该脚本，添加一个 VirtualHost 配置：

<VirtualHost *:80>
    ServerName gitserver
    DocumentRoot /var/www/gitweb
    <Directory /var/www/gitweb>
        Options +ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch
        AllowOverride All
        order allow,deny
        Allow from all
        AddHandler cgi-script cgi
        DirectoryIndex gitweb.cgi
    </Directory>
</VirtualHost>

不难想象，GitWeb 可以使用任何兼容 CGI 的网页服务来运行；如果偏向使用其他 web 服务器，配置也不会很麻烦。现在，通过 http://gitserver 就可以在线访问仓库了，在 http://git.server 上还可以通过 HTTP 克隆和获取仓库的内容。

按照上面的配置可能会产生的问题：
首先这个需要Apache的cgi模块，检查发现只安装一个mod_cgid.so还差一个mod_cgi.so，这种情况下怎么能不重新编译的情况下安装mod_cgi.so模块？

如要额外安装cgi，先找到mod_cgi.c及mod_cgid.c。一般在apache安装包目录下，如 ./httpd-2.2.25/modules/generators 。

#编译安装 cgi模块
cd /usr/local/src/Apache-2.2.25/httpd-2.2.25/modules/generators
/usr/local/apache/bin/apxs -i -a -c mod_cgi.c
编译成功后会输出：
cd /usr/local/src/Apache-2.2.25/httpd-2.2.25/modules/generators
/usr/local/apache/bin/apxs -i -a -c mod_cgi.c

…. #省略掉了前部分内容
chmod 755 /usr/local/apache/modules/mod_cgi.so
[activating module `cgi’ in /usr/local/apache/conf/httpd.conf] #这行表示，在httpd.conf中已经加载了cgi module

#编译安装 cgid模板
cd /usr/local/src/Apache-2.2.25/httpd-2.2.25/modules/generators
/usr/local/apache/bin/apxs -i -a -c mod_cgid.c
编译成功后会输出：
view source?
…. #省略掉了前部分内容
chmod 755 /usr/local/apache/modules/mod_cgid.so
[activating module `cgid’ in /usr/local/apache/conf/httpd.conf] #这行表示，在httpd.conf中已经加载了cgid module

asps参数含义:
-i 表示需要执行安装操作。
-a 自动增加一个LoadModule行到httpd.conf文件中，以激活此模块，或者，如果此行已经存在，则启用之。
-n 增加或启用的模块名称。

# 再次查看下配置文件 httpd.conf：
LoadModule cgi_module modules/mod_cgi.so
LoadModule cgid_module modules/mod_cgid.so
cgi与cgid模块被加载。

配置文件：

<VirtualHost *:80>
ServerName gitweb.xxx.com
DocumentRoot “/var/www/gitweb”
<Directory “/var/www/gitweb”>
Options +ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch
AllowOverride All
order allow,deny
Allow from all
AddHandler cgi-script cgi .cgi
DirectoryIndex gitweb.cgi
</Directory>
ErrorLog “logs/gitweb.yuu1.com-error_log”
CustomLog “logs/gitweb.yuu1.com-access_log” common
</VirtualHost>

这里还需要运行perl和cgi脚本，一直访问不了，显示500，查看Apache错误日志：

[root@localhost logs]# tail error_log -f
BEGIN failed–compilation aborted at /var/www/gitweb/gitweb.cgi line 13.
Can’t locate CGI.pm in @INC (@INC contains: /usr/local/lib64/perl5 /usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5 .) at /var/www/gitweb/gitweb.cgi line 13.

题很简单应该是去CPAN网站下载CGI相关程序。在shell下执行：

#perl -e shell -MCPAN

# install CGI

然后再次访问，出现

[Wed Nov 19 16:58:43 2014] gitweb.cgi: Can’t locate Time/HiRes.pm in @INC (@INC contains: /usr/local/lib64/perl5 /usr/local/share/perl5 /usr/lib64/perl5/vendor_perl /usr/share/perl5/vendor_perl /usr/lib64/perl5 /usr/share/perl5 .) at /var/www/gitweb/gitweb.cgi line 20.
[Wed Nov 19 16:58:43 2014] gitweb.cgi: BEGIN failed–compilation aborted at /var/www/gitweb/gitweb.cgi line 20.

解决方法：
yum install perl-Time-HiRes
perl -MCPAN -e 'install Time::HiRes' 
提示找不到CPAN
yum install perl-devel perl-CPAN 
perl -MCPAN -e shell 
cpan[2]> install Time::HiRes 
cpan[3]> exit 

最后终于可以访问gitweb了。后面的上传到时再补充。

版权属于: 运维之道

原文地址: http://www.myjishu.com/?p=155

转载时必须以链接形式注明原始出处及本声明。