2016-03-29

git干货系列：（六）公司内部搭建git服务器

前言

因为gitHub上的项目是公开的，不适合公司内部项目放在上面，而私人的需要收费，这绝非是我们愿意的。所以找了个跟gitHub很相似，但是又免费的gitLab。现在将搭建gitLab过程记录一下留作参考。

正文

gitLab介绍

GitLab是利用 Ruby on Rails 一个开源的版本管理系统，实现一个自托管的Git项目仓库，可通过Web界面进行访问公开的或者私人项目。它拥有与Github类似的功能，能够浏览源代码，管理缺陷和注释。可以管理团队对仓库的访问，它非常易于浏览提交过的版本并提供一个文件历史库。团队成员可以利用内置的简单聊天程序(Wall)进行交流。它还提供一个代码片段收集功能可以轻松实现代码复用，便于日后有需要的时候进行查找。

依赖组件：ruby 1.9.3+，MySQL，git，redis， Sidekiq。
最低配置CPU 1G，RAM 1G+swap可以支持100用户。

先连接SSH

首先要确定ubuntu上安装并且启动了ssh服务,然后还要确保linux系统上的防火墙要关闭,win8的防火墙可以正常开启
SSH(仿真终端工具有PUTTY，SecureCRT 以及Fterm等）可以google下载的了.
步骤:
1, 有人说首先要在Virtual Network Editor做NAT的端口映射,其实是不需要的;

1	ps -e\|grep ssh

如果结果中只有ssh-agent,那说明ssh-server还没有启动,一般ubuntu是默认安装ssh的,要是没有安装,可以通过

1	sudo apt-get install openssh-server

安装ssh服务

1	sudo /etc/init.d/ssh start

启动ssh服务

初始化root密码

ubuntn刚安装时候root还没有密码，设置一个，使用命令

1	sudo passwd

安装gitlib整合包

官方有安装包与脚本下载，官方安装指南。同样GITHUB上有个社区非官方的安装指南。
但这儿里推荐bitnami下载打包安装版本 https://bitnami.com/stack/gitlab/installer ,省去很多时间。他们也提供相关WIKI
以ubuntu为演示环境，来安装这个包，切换到root账户, 在终端运行：
如果没有权限，先授权账号：

1	chmod 777 bitnami-gitlab-8.5.7-0-linux-x64-installer.run

然后切换root用户执行：

1	./bitnami-gitlab-8.5.7-0-linux-x64-installer.run

执行后就会弹出图形化界面，一步步确认就行，如下图

启动命令

第一次安装好了就默认启动了gitlab，如果要手动启动的话有两种办法
1.找到安装好的路径/opt/gitlab-8.5.7-0
需要root权限执行命令：

sudo ./ctlscript.sh start
```  
![](http://7xqch5.com1.z0.glb.clouddn.com/git6_8.png)  


2.也可以查看`GUI`管理控制台，在`Manage Servers中`选择`Start All`启动所有
``` bash
sudo ./manager-linux-x64.run

登陆系统

启动后，就可以访问系统页面了，这里先通过ifconfig命令获取当前的ip地址

我的是192.168.153.128，于是就可以在外面window系统浏览器访问

http://192.168.153.128/users/sign_in

使用我之前配置的git登陆,我之前安装的时候配置的管理员账号是git,密码12345678，
这里我登陆后发现跳转到404页面，把地址http://192.168.153.128/users/sign_in
后面的users/sign_in删掉回车就行,就去后界面如下：

创建项目前的设置

如果你是自己一个人玩就直接创建项目即可，因为我这边是给团队使用的，所以需要创建一下用户组，以及添加组成员，配置权限等，下面来介绍这些配置

配置服务器邮件

添加人员或者自己注册的时候需要发邮件激活，所以要先配置服务器，我在bitnami提供的wiki里面找到了办法，原文如下：

How to configure the email settings of GitLab?
You can configure the SMTP settings during the installation process. If you are using the Virtual Machine or AMI, you can configure it manually. For example, these are the options to configure it using a GMail account:
/opt/bitnami/apps/gitlab/htdocs/config/environments/production.rb
1
2
3
4
5
6
7
8
9
10
11
12
config.action_mailer.raise_delivery_errors = true
config.action_mailer.delivery_method = :smtp   
config.action_mailer.perform_deliveries = true
config.action_mailer.smtp_settings = {
:address => "smtp.gmail.com",
:port => 587,
:domain => "gmail.com",
:authentication => :plain,
:user_name => "your_account@gmail.com",
:，password => "your_password",
:enable_starttls_auto => true 
}

简单的说就是修改/opt/bitnami/apps/gitlab/htdocs/config/environments/production.rb文件，里面的内容，address，domain，user_name，password这几个配置成你自己的邮箱，记得你的邮箱必须要支持smtp。port端口我默认也是587，不需要修改。
配置好了邮箱，就要测试一下，我们在http://192.168.153.128/users/sign_in 首页，注册一个额用户，然后我收到邮件激活，然后就可以登陆系统了。

可以看到，非管理员登陆右上角就没有Admin Area功能

创建小组，添加组内成员

让组内成员自己注册账号激活后，我们就准备创建小组了，创建小组是为了方便管理，创建项目的时候直接指定小组，这样小组内的成员都可以看到项目

新增项目

小组创建好了就可以新增一个项目了,这里创建的时候选择edw这个创建好的小组，并且项目宣称private私有项目。这样只有小组内的成员可以下载这个项目

配置SSH key

这里切换到tengj用户登陆，发现已经有了springmvctouchbaidu项目

但是要下载到本地还需要配置SSH key,复制我们本地\.ssh\id_rsa.pub的内容黏贴到下面图中指定的即可。

远程下载项目

这里模拟tengj下载远程项目，在这之前我已经用管理员账号把项目传上去了，如图

指定一个目录存放该项目，执行git clone命令：

$ git clone git@192.168.153.128:edw/springmvctouchbaidu.git
Cloning into 'springmvctouchbaidu'...
The authenticity of host '192.168.153.128 (192.168.153.128)' can't be established.
ECDSA key fingerprint is SHA256:1SgfW1DLmaZ9m/E82vVtWjBK1AaP+LMW5U4ng8nv6uE.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '192.168.153.128' (ECDSA) to the list of known hosts.
remote: 对象计数中: 339, 完成.
remote: 压缩对象中: 100% (242/242), 完成.
remote: Total 339 (delta 68), reused 339 (delta 68)
Receiving objects: 100% (339/339), 12.97 MiB | 14.44 MiB/s, done.
Resolving deltas: 100% (68/68), done.
Checking connectivity... done.

搞定，下载下来了。

配置权限

前面文章也说过，一般一个实际项目中master用来版本发布，一般不在这个分支上开发，所以除了git管理员用户可以提交代码到master外，其他组成员只能push代码到dev这个分支。
比如我添加tengj用户的时候选择的是Developer角色，只要在Protected Branches中这个勾不够上就行了。这样开发人员就无法push代码到master分支上。