私有git 搭建

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了私有git 搭建相关的知识,希望对你有一定的参考价值。

这里使用的操作系统是CentOS release 5.9 (Final),并且已经安装了Git和一些必要的开发工具。

在服务器上创建用户和项目仓库(repository)

  1. useradd git #创建git用户  

  2. passwd git #设置密码  

  3. su git #切换到git用户  

  4. cd ~/ #切换到home目录  

  5. git init --bare cube #创建一个叫cube的项目仓库 

clone项目并提交修改(本地)

git clone [email protected]地址:cube ~/cube 

需要说明的是这里会要求输入用户git的密码,我们稍后建立主机信任后就不需要输入密码了.
然后在cube下创建一个README.txt

  1. git add *  

  2. git commit -m "create new file"  

  3. git push origin master

建立主机信任关系

在本地执行

  1. ssh-keygen -t rsa  

  2. cat ~/.ssh/id_rsa.pub

拷贝文件公钥内容

在服务器执行

  1. mkdir ~/.ssh  

  2. chmod 755 ~/.ssh  

  3. touch ~/.ssh/authorized_keys  

  4. chmod 600 ~/.ssh/authorized_keys  

  5. echo 拷贝的公钥 >> ~/.ssh/authorized_keys 

要注意文件权限的问题.

使用gitosis来配置和管理git服务端

Gitosis是为托管的Git存储库提供访问控制和远程管理的工具它允许通过SSH对读写访问进行细粒度管理,而不需要用户在服务器上具有本地系统帐户。为此,它设置一个单一的系统帐户“ git”,然后用于所有Git访问。

AUR安装gitosis-git AUR包。这将创造三件事:

  • git用户

  • git该用户所属的组

  • /srv/gitosis目录将保存Gitosis的数据和存储库

要配置Gitosis,您不要直接在服务器上编辑文件。相反,Gitosis提供了一个包含配置的Git存储库。要更新此配置,您gitosis-admin可以像任何其他存储库一样克隆,提交和推送。

由于Gitosis使用SSH密钥对用户进行身份验证,因此您将需要生成一个用于管理存储库的密钥对。如果没有,可以使用ssh-keygen例如:

$ ssh-keygen -t rsa

您现在可以初始化管理存储库。

$ sudo -H -u git gitosis-init </path/to/public_key.pub
初始化的空Git仓库在/srv/gitosis/repositories/gitosis-admin.git/
在/srv/gitosis/repositories/gitosis-admin.git/中重新初始化现有的Git仓库

注意:在某些情况下,这可能会导致此类错误:

OSError:[Errno 13] Permission denied:‘// gitosis‘

原因可能是git主目录没有正确设置。通过手动设置来修复它:

#usermod -d / srv / gitosis git

此外,此命令创建/srv/gitosis/repositories将存储实际托管存储库的目录。

在管理存储库初始化完成后,禁用用户git的基于密码的ssh登录可能是合理的。

要实现这一点,添加

匹配用户git
密码验证号

在......的最后 /etc/ssh/sshd_config

组态

如上所述,通过将提交推送到gitosis-admin存储库来配置Gitosis 。要克隆此存储库(使用Gitosis!),请运行:

$ git clone [email protected]:gitosis-admin.git

gitosis-admin存储库中,您将看到两件事:

  • gitosis.conf - Gitosis和存储库权限的配置文件

  • keydir - 包含每个用户公用密钥的目录

要修改存储库或用户,或配置Gitosis,只需提交克隆中的更改并将其推回到服务器。

存储库和权限

您可以在/ usr / share / doc / gitosis中找到一些示例配置文件。

[Gitosis的]
gitweb = yes

[repo foobar]
description = foobar的Git仓库
owner = user

[组开发者]
members = user1 user2

[组管理员]
members = user1

[组gitosis-admin]
writable = gitosis-admin
members = @admins

[组foobar]
可写= foobar
members = @devs

[组myteam]
writable = free_monkey
会员= jdoe

[组部署者]
writable = free_monkey
readonly = monkey_deployer

这定义了一个名为“free_monkey”的新组,它是一个任意字符串。“jdoe”是myteam的成员,可以访问“gitosis”存储库。“monkey_deployer”键将只能访问“free_monkey”。

将此添加到gitosis.conf中,提交并推送它:

$ git commit -a -m“允许jdoe写入访问free_monkey”
$ git push

现在,用户“jdoe”可以访问名为“free_monkey”的存储库,但是我们还没有创建一个存储库。我们将做的是在本地创建一个新的存储库,在Git服务器上进行初始化,然后推送它:

$ mkdir free_monkey
$ cd free_monkey
$ git init
$ git remote add origin git @ YOUR_SERVER_HOSTNAME:free_monkey.git

做一些工作,git添加和提交文件

$ git push origin master:refs / heads / master

当使用SSH时,最后一个命令将失败,并显示错误消息“不显示为Git存储库”这可以通过在服务器上手动初始化存储库来修复

$ git init --bare /srv/gitosis/repositories/free_monkey.git

并重试最后一个命令

随着最后的推动,你将会参加比赛。存储库“free_monkey”已在服务器上创建(在/ srv / gitosis / repositories中),您可以像任何ol‘Git存储库一样开始使用它。

Git病毒库也可以用于gitweb; 只需将gitweb配置中包含存储库的目录指向。

添加用户

下一个自然的事情是让幸运的几个提交访问FreeMonkey项目。这是一个简单的两步过程。

首先,收集他们的公共SSH密钥,我将其称为“alice.pub”和“bob.pub”,并将其放入当地gitosis-admin存储库的keydir /。其次,编辑gitosis.conf并将其添加到“成员”列表中。

$ cd gitosis-admin
$ cp/ alice.pub keydir /
$ cp/ bob.pub keydir /
$ git add keydir / alice.pub keydir / bob.pub

请注意,密钥文件名必须有“.pub”扩展名。

gitosis.conf更改:

[组myteam]
member = jdoe alice bob
writable = free_monkey

提交和推送:

$ git commit -a -m“授予Alice和Bob授予FreeMonkey的权限”
$ git push

而已。Alice和Bob现在可以像这样克隆free_monkey存储库:

$ git clone git @ YOUR_SERVER_HOSTNAME:free_monkey.git

爱丽丝和鲍勃也将有承诺的权利。

公共访问

如果您正在运行一个公共项目,您的用户将拥有提交权限,然后您将拥有其他所有人。我们如何让别人只读访问,而不用SSH密钥?

我们只是使用git-daemon。这是独立于Gitosis,它与Git本身一起。

$ sudo -u git git-daemon --base-path = / srv / gitosis / repositories / --export-all

这将使您使用Gitosis管理的所有存储库对于公众来说是只读的。有人可以像这样克隆FreeMonkey:

$ git clone git://YOUR_SERVER_HOSTNAME/free_monkey.git

要仅导出一些存储库而不是其他存储库,您需要在要公开的每个存储库的根目录(例如/srv/gitosis/repositories/free_monkey.git)内触摸git-daemon-export-ok。然后从上面的git-daemon命令中删除“--export-all”。

更多的技巧

gitosis.conf可以设置做一些其他的巧妙的技巧。在Gitosis源目录中打开example.conf(您最初在顶部克隆Gitosis方式),以查看所有选项的摘要。您可以将一些存储库指定为只读(与可写)相反,但尚未公开)。组成员列表可以包括另一个组。还有一些其他的技巧,我会留给读者发现。

注意事项

如果您的服务器上的/srv/gitosis/.gitosis.conf似乎没有更新,以匹配您的本地副本(他们应该匹配),即使您正在进行更改和推送,可能是您的更新后挂接不可执行。较旧版本的setuptools可能导致这种情况。一定要解决这个问题:

#chmod 755 /srv/gitosis/repositories/gitosis-admin.git/hooks/post-update

如果您的Python好东西处于非标准位置,则必须另外编辑更新后,并在顶部放置“export PYTHONPATH = ...”行。第一次尝试在gitosis-admin中推送更改时,不这样做会给您一个Python堆栈跟踪。

如果您想在非标准位置安装Gitosis,我不推荐它。这是一个边缘的情况,作者没有反抗,直到我发现他帮助我让它工作。

对于勇气,您需要编辑系统上的任何文件来控制非登录,非交互式shell的默认PATH。在Ubuntu上,这是/ etc / environment。将Gitosis的路径添加到PATH行。还为PYTHONPATH插入一行,并将其设置为非标准的Python site-packages目录。例如,这是我的/ etc / environment:

$ PATH =“/ home / $(whoami)/ sys / bin:/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin:/ sbin:/ bin:/ usr / bin / X11:在/ usr /游戏”
$ PYTHONPATH = / home / $(whoami)/sys/lib/python2.4/site-packages

进行这些更改后,请务必注销并重新登录。

不要使用我上面提到的gitosis-init行进行标准安装,而是使用这个略微修改的代码:

$ sudo -H -u git env PATH = $ PATH gitosis-init </tmp/id_rsa.pub

确保在上述更新后的钩子中设置PYTHONPATH。

那个*应该这样做 我有目的地简化了这个非标准的设置,因为我认为没有很多人会使用它。如果您需要更多信息(我的nick是up_the_irons),请在FreeNode上的#git中打开我。

非标准SSH端口

如果您在服务器上的非标准端口上运行SSH,则有两种方法可以指定Git将尝试连接哪个端口。一个是明确声明您正在使用SSH协议,因为这可以让您在该URL中输入端口号:

git clone ssh://[email protected]:1234 / repo.git

或者你可以把它放在你的/ .ssh / config文件中:

$ Host myserver.com
$ Port 1234
  • [repo]块用于定义与gitweb一起使用的一些必要区域。

  • [组]块用于两者:

    • 定义用户组

    • 定义存储库权限

  • @用于定义用户组。

您应该提交并推送您在此文件中所做的任何更改。

keydir

keydir只是一个包含用户公钥的目录。一些键可以是user @ machine的形式,这些键必须用gitosis.conf中的那个格式定义。最好创建用户组并将其用作存储库的成员。一旦添加新的密钥来启用一些新用户,您应该将文件添加到Git存储库并提交并推送它们。新用户将使用上述格式的Git命令,就像您用来克隆gitosis-admin存储库一样。


gitweb

开启gitweb支持

gitweb是一个简单的可视化网页界面,可以使用任何兼容CGI的网页服务来运行,这里选用的Apache

  1. git clone git://git.kernel.org/pub/scm/git/git.git  

  2. cd git/  

  3. make GITWEB_PROJECTROOT="/home/git/repositories"\  

  4.     GITWEB_JS="gitweb/static/gitweb.js" \  

  5.     GITWEB_CSS="gitweb/static/gitweb.css" \  

  6.     GITWEB_LOGO="gitweb/static/git-logo.png" \  

  7.     GITWEB_FAVICON="gitweb/static/git-favicon.png" \  

  8.     bindir=/usr/local/bin \  

  9.     gitweb  

  10. make gitwebdir=/var/www/cgi-bin/gitweb install-gitweb 

需要注意的是GITWEB_PROJECTROOT应该修改成你的仓库的路径,并且其权限(包括子目录)应是705。

然后修改/etc/gitweb.conf,改成下面的样子

[plain] view plain copy

  1. $projectroot = "/home/git/repositories"; #仓库路径  

  2. $GIT = "/usr/local/bin/git"; #git可执行文件路径 

修改apache配置文件

在/etc/httpd/conf/httpd.conf中加入以下内容:

  1. <VirtualHost *:80>  

  2.     ServerName gitserver  

  3.     DocumentRoot /var/www/cgi-bin/gitweb  

  4.     <Directory /var/www/cgi-bin/gitweb>  

  5.         Options ExecCGI +FollowSymLinks +SymLinksIfOwnerMatch  

  6.         AllowOverride All  

  7.         order allow,deny  

  8.         Allow from all  

  9.         AddHandler cgi-script cgi  

  10.         DirectoryIndex gitweb.cgi  

  11.     </Directory>  

  12. </VirtualHost>  

这就弄好了!

可能遇到的问题

用户认证不通过的问题:

git clone [email protected]:gitosis-admin.git
Initialized empty Git repository in /home/yang/gitosis-admin/.git/
Agent admitted failure to sign using the key.
Permission denied (publickey).
fatal: The remote end hung up unexpectedly


// 解决方法,在管理员PC上 
# ssh-add   ~/.ssh/id_rsa 

gitweb找不到工程的问题

如果遇到gieweb的页面显示找不到工程,多半是权限设置错误。

简单的说就是Apache用户组不具备访问你仓库目录的权限,例如我的仓库是放在/home/git/repositories下的,所以应将/home/git和/home/git/repositories以及你仓库中的所有项目的权限都设置成705,之前在网上发现有人说设置成775的,如果你设置成775的话虽然也能用,但会导致无法使用命令访问代码仓库,原因我还不清楚。



本文出自 “梦想照进现实” 博客,请务必保留此出处http://lookingdream.blog.51cto.com/5177800/1945807

以上是关于私有git 搭建的主要内容,如果未能解决你的问题,请参考以下文章

Gitea——私有git服务器搭建详细教程

Gitea——私有git服务器搭建详细教程

搭建本地私有的git服务器

私有git搭建

使用Git与GitHub协同开发并搭建私有GitLab代码托管服务器

CI/CD之搭建私有git仓库gitlab