同步首发：http://www.yuanrengu.com/index.php/20171112.html

一.GitLab简介

GitLab是利用Ruby On Rails开发的一个开源版本管理系统，实现了一个自托管的Git项目仓库，是集代码托管，测试，部署于一体的开源git仓库管理软件，可通过web界面来进行访问公开的或私人项目。与Github类似，GitLab能够浏览代码，管理缺陷和注释。可以管理团队对仓库的访问，它非常易于浏览提交过的版本，并提供一个文件历史库。它还提供一个代码片段收集功能可以轻松实现代码复用，便于日后需要的时候查找。

Git的家族成员：

• Git：是一种版本控制系统，是一个命令，是一种工具。
• Gitlib：是用于实现Git功能的开发库。
• Github：是一个基于Git实现的在线代码托管仓库，公开项目是免费的，也可以付费创建私人项目。
• GitLab：是一个基于Git实现的在线代码仓库托管软件，可以用GitLab搭建一套类似Github的系统。
  

GitLab对硬件还是有一定要求的，1核心的CPU基本上可以满足需求，大概支撑100个左右的用户，不过在运行GitLab网站的同时还需要运行多个后台job，就会显得有点捉襟见肘了。需要至少4GB的可寻址内存（RAM交换）来安装和使用GitLab，操作系统和任何其他正在运行的应用程序也将使用内存，因此请记住，在运行GitLab之前，您至少需要4GB的可用空间。如果使用更少的内存，GitLab将在重新配置运行期间给出奇怪的错误，我用虚拟机来分别新建1G,2G内存的CentOS系统来装GitLab，确实非常捉襟见肘啊，伤不起。

二.GitLab的安装

1.在CentOS系统上，下面的命令将会打开系统防火墙HTTP和SSH访问。

sudo yum install curl policycoreutils openssh-server openssh-clients
sudo systemctl enable sshd
sudo systemctl start sshd
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix
sudo firewall-cmd --permanent --add-service=http
sudo systemctl reload firewalld

2.添加GitLab镜像源并安装

curl -sS http://packages.gitlab.com.cn/install/gitlab-ce/script.rpm.sh | sudo bash

这是官方的yum源，安装速度会比较慢，可以使用国内源，修改如下文件即可：

vim /etc/yum.repos.d/gitlab_gitlab-ce.repo

修改内容如下：

[gitlab-ce]
name=gitlab-ce
baseurl=http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7
repo_gpgcheck=0
gpgcheck=0
enabled=1
gpgkey=https://packages.gitlab.com/gpg.key

然后执行：

sudo yum install gitlab-ce
#配置并启动 GitLab
sudo gitlab-ctl reconfigure

安装成功会有如下提示：

3.第一次访问GitLab，系统会重定向页面到重定向到重置密码页面，你需要输入初始化管理员账号的密码，管理员的用户名为root，初始密码为5iveL!fe。重置密码后，新密码即为刚输入的密码。

三.GitLab的汉化

成功安装GitLab后，很多朋友会想到汉化，当然如果团队里英文水平都不错的话，是没必要汉化的。

GitLab中文社区的项目，v7-v8.8是由Larry Li发起的“GitLab中文社区版项目”（https://gitlab.com/larryli/gitlab），从v8.9之后由@xhang开始继续汉化项目（https://gitlab.com/xhang/gitlab）。

mkdir /home/local/gitlab
cd /home/local/gitlab

如没安装git，需提前安装：

yum install -y git

下载最新的汉化包：

git clone https://gitlab.com/xhang/gitlab.git

如果是要下载老版本的汉化包，需要加上老版本的分支，如果想下载10.0.2，可以运行如下语句：

git clone https://gitlab.com/xhang/gitlab.git -b v10.0.2-zh

停止GitLab并执行如下语句：

gitlab-ctl stop
cp  /home/local/gitlab/*  /opt/gitlab/embedded/service/gitlab-rails/  -rf

复制时可能不断提示是否要覆盖，这时可能是系统每次执行cp命令时，其实是执行了cp -i命令的别名。出现这种情况可以修改~/.bashrc，在“alias cp=’cp-i’”前加#注释即可。

复制可能出现如下提示，可以不用理会。

注释后记得执行：

source ~/.bashrc

或者重启即可。

接下来可以重新配置和启动：

sudo gitlab-ctl reconfigure
sudo gitlab-ctl restart 

成功汉化后的界面如下：

四.GitLab的命令

语法:

gitlab-ctl command (subcommand)

例子：

 #启动所有服务
[root@gitlab ~]# gitlab-ctl start

#启动单独一个服务
[root@gitlab ~]# gitlab-ctl start nginx

#查看日志，查看所有日志
[root@gitlab ~]# gitlab-ctl tail

#查看具体一个日志,类似tail -f
[root@gitlab ~]# gitlab-ctl tail nginx

例子：

 #显示所有服务配置文件
[root@gitlab ~]#gitlab-ctl show-config

#卸载gitlab
[root@gitlab ~]#gitlab-ctl uninstall

 五.QQ邮箱配置

默认情况下，GitLab用qq邮箱注册是发不出确认邮件的。查看了网上很多邮箱配置的教程，大部分都是误导的。

像这类软件，归根到底总结为一句话：一切以官网文档为准。

qq邮箱最好用企业邮箱，本人用个人邮箱进行测试是有些小问题的。

正确配置如下：

# vim /etc/gitlab/gitlab.rb
 
gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "xxxx@xx.com"
gitlab_rails['smtp_password'] = "password"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = 'xxxx@xx.com'

大家如果在安装和使用的过程有遇到什么问题，可以在我的个人博客里留言，希望对大家有些许帮助。

参考：https://www.gitlab.cc/installation/#centos-7
           https://yq.aliyun.com/articles/74395