史上最全Gitlab部署

一、前言

1、本文主要内容

• GitLab社区版部署
• GitLab配置禁用创建组权限
• GitLab配置邮件(SMTP)
• Gitlab备份配置

• GitLab常用命令说明

  2、GitLab介绍

  GitLab一个开源的git仓库管理平台，方便团队协作开发、管理。在GitLab上可以实现完整的CI（持续集成）、CD（持续发布）流程。而且还提供了免费使用的Plan，以及免费的可以独立部署的社区版本(https://gitlab.com/gitlab-org/gitlab-ce )。官网：https://about.gitlab.com/

  二、准备工作

  1、安准基础依赖（这一步基本都可以跳过，很多服务器默认安装）

  #安装技术依赖
  sudo yum install -y curl policycoreutils-python openssh-server
  
  #启动ssh服务&设置为开机启动
  sudo systemctl enable sshd
  sudo systemctl start sshd

  2、安装Postfix

  Postfix是一个邮件服务器，GitLab发送邮件需要用到

  #安装postfix
  sudo yum install -y postfix
  
  #启动postfix并设置为开机启动
  sudo systemctl enable postfix
  sudo systemctl start postfix

  3、开放ssh以及http服务

  根据实际情况执行，公司内部服务器初始时，防火墙就没打开

  #开放ssh、http服务
  sudo firewall-cmd --add-service=ssh --permanent
  sudo firewall-cmd --add-service=http --permanent
  
  #重载防火墙规则
  sudo firewall-cmd --reload

  三、部署过程

  本次我们部署的是社区版:gitlab-ce，如果要部署商业版可以把关键字替换为：gitlab-ee

  1、Yum安装GitLab

• 添加GitLab社区版Package

  curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash 

• 安装GitLab社区版

  sudo yum install -y gitlab-ce 

  安装成功后会看到gitlab-ce打印了以下图形
  

异常处理：

出现“policycoreutils-python is needed by问题”，应该是在安装gitlab时，gitlab的版本是centos7的，如果你确定你的centos版本是centos7
​

解决方法：

sudo yum installpolicycoreutils-python

如果这个方法无效，你的centos版本一定不是centos7
如果你的centos版本是centos8.那么换一个gitlab版本，也就是重新下载一个，这里是最新地址

https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el8/

下载命令：

wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el8/gitlab-ce-12.10.1-ce.0.el8.x86_64.rpm

安装：

sudo rpm -i gitlab-ce-12.10.1-ce.0.el8.x86_64.rpm

若出现错误“policycoreutils-python-utils is needed by gitlab-ce-12.10.1-ce.0.el8.x86_64”
解决办法：

sudo yum install policycoreutils-python-utils

然后重新安装。
​

参考：https://blog.csdn.net/fu18838928050/article/details/107901895

2、配置GitLab站点Url

GitLab默认的配置文件路径是/etc/gitlab/gitlab.rb
默认的站点Url配置项是：

external_url 'http://gitlab.example.com'

​

这里我将GitLab站点Url修改为"external_url 'http://192.168.0.80:9000"
也可以用IP代替域名，这里根据自己需求来即可

#修改配置文件
sudo vi /etc/gitlab/gitlab.rb

#配置首页地址（大约在第15行）
external_url 'http://192.168.0.80:9000'

3、启动并访问GitLab

• 启动GitLab

  #重新配置并启动
  sudo gitlab-ctl reconfigure
  
  #完成后将会看到如下输出
  Running handlers complete
  Chef Client finished, 432/613 resources updated in 03 minutes 43 seconds
  gitlab Reconfigured!

• 访问GitLab

将设置的域名DNS解析到服务器IP，或者修改本地host将域名指向服务器IP。
访问：http://192.168.0.80:9000

这时候会提示为管理员账号设置密码。管理员账号默认username是root。
设置完成之后即可使用root账号登录，登陆后会进入欢迎界面。

四、GitLab常用配置

1、邮件配置

配置邮箱可以让GitLab在发生相应事件的时候进行邮件通知
比如配置腾讯企业邮箱如下：

gitlab_rails['smtp_enable'] = true
gitlab_rails['smtp_address'] = "smtp.exmail.qq.com"
gitlab_rails['smtp_port'] = 465
gitlab_rails['smtp_user_name'] = "你的邮箱"
gitlab_rails['smtp_password'] = "你的邮箱密码"
gitlab_rails['smtp_domain'] = "exmail.qq.com"
gitlab_rails['smtp_authentication'] = "login"
gitlab_rails['smtp_enable_starttls_auto'] = true
gitlab_rails['smtp_tls'] = true
gitlab_rails['gitlab_email_from'] = '你的邮箱'

具体参考：
https://docs.gitlab.com/omnibus/settings/smtp.html

2、禁用创建组权限

GitLab默认所有的注册用户都可以创建组。但对于团队来说，通常只会给Leader相关权限。
虽然可以在用户管理界面取消权限，但毕竟不方便。我们可以通过配置GitLab默认禁用创建组权限。

#修改配置文件
sudo vi /etc/gitlab/gitlab.rb

#开启gitlab_rails['gitlab_default_can_create_group'] 选项，并将值设置为false
### GitLab user privileges
gitlab_rails['gitlab_default_can_create_group'] = false

#保存后，重新配置并启动GitLab
sudo gitlab-ctl reconfigure

3.配置代码位置

找到git_data_dirs 选型，配置地址

git_data_dirs({
   "default" => {
     "path" => "/data/tools/gitlab/data"
    }
})

参考链接：https://docs.gitlab.com/omnibus/settings/configuration.html
​

4.gitlab 备份

1）修改配置文件

# 打开gitlab配置文件
vim /etc/gitlab/gitlab.rb

#设置备份文件的保存位置
gitlab_rails['backup_path'] = "/data/tools/gitlab/backup"

#设置备份文件的过期时间，单位为秒，默认7天
gitlab_rails['backup_keep_time'] = 604800

执行wq保存后，刷新配置

gitlab-ctl reconfigure

2）执行备份命令验证

执行备份命令，去对应的文件路径查看是否已经创建了备份文件

gitlab-rake gitlab:backup:create

执行打印如下：

红色字体描述为 gitlab.rb 和gitlab-secrets.json为敏感文件需要手动备份
​

3）通过cron定时备份

方法1、在命令行输入: crontab -e 然后添加相应的任务，wq存盘退出。

#输入命令crontab -e
crontab -e  
#输入相应的任务
0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create CRON=1  

方法2、直接编辑/etc/crontab 文件，即vim /etc/crontab，然后添加相应的任务

# edited by ouyang 2017-8-11 添加定时任务，每天凌晨两点，执行gitlab备份
0  2    * * *   root    /opt/gitlab/bin/gitlab-rake gitlab:backup:create CRON=1

重启cron服务

systemctl restart crond.service

​

5.gitlab-ctl常用命令介绍

命令	说明
check-config	检查在gitlab中是否有任何配置。在指定版本中删除的rb
deploy-page	安装部署页面
diff-config	将用户配置与包可用配置进行比较
remove-accounts	删除所有用户和组
upgrade	升级
service-list	查看所有服务
once	如果GitLab服务停止了就启动服务，如果已启动就不做任何操作
restart	重启GitLab服务
start	如果GitLab服务停止了就启动服务，如果已启动就重启服务
stop	停止GitLab服务
status	查看GitLab服务状态
reconfigure	reconfigure重新配置GitLab并启动

参考链接：
https://ken.io/note/centos7-gitlab-install-tutorial