版本管理 GitLab 的安装及管理 (CentOS 7)

原创

wzlinux 2018-09-03 10:44:15 博主文章分类：DevOps ©著作权

文章标签 gitlab 版本管理 文章分类 开源

©著作权归作者所有：来自51CTO博客作者wzlinux的原创作品，请联系作者获取转载授权，否则将追究法律责任

一、前言

GitLab是利用 Ruby on Rails 一个开源的版本管理系统，实现一个自托管的 Git 项目仓库，可通过 Web 界面进行访问公开的或者私人项目。

它拥有与 Github 类似的功能，能够浏览源代码，管理缺陷和注释。可以管理团队对仓库的访问，它非常易于浏览提交过的版本并提供一个文件历史库。

团队成员可以利用内置的简单聊天程序(Wall)进行交流。

它还提供一个代码片段收集功能可以轻松实现代码复用，便于日后有需要的时候进行查找。

1、Git的家族成员

**Git：**是一种版本控制系统，是一个命令，是一种工具。
**Gitlib：**是用于实现Git功能的开发库。
**Github：**是一个基于Git实现的在线代码托管仓库，包含一个网站界面，向互联网开放。
**GitLab：**是一个基于Git实现的在线代码仓库托管软件，你可以用gitlab自己搭建一个类似于Github一样的系统，一般用于在企业、学校等内部网络搭建git私服。

2、Gitlab的服务构成

**Nginx：**静态web服务器。
**gitlab-shell：**用于处理Git命令和修改authorized keys列表。
**gitlab-workhorse：**轻量级的反向代理服务器。
**logrotate：**日志文件管理工具。
**postgresql：**数据库。
**redis：**缓存数据库。
**sidekiq：**用于在后台执行队列任务（异步执行）。
**unicorn：**An HTTP server for Rack applications，GitLab Rails应用是托管在这个服务器上面的。

3、GitLab工作流程

4、GitLab Shell

GitLab Shell有两个作用：为GitLab处理Git命令、修改authorized keys列表。

当通过SSH访问GitLab Server时，GitLab Shell会限制执行预定义好的Git命令（git push, git pull, git annex），调用GitLab Rails API 检查权限，执行pre-receive钩子（在GitLab企业版中叫做Git钩子），执行你请求的动作处理GitLab的post-receive动作，处理自定义的post-receive动作。

当通过http(s)访问GitLab Server时，工作流程取决于你是从Git仓库拉取(pull)代码还是向git仓库推送(push)代码。如果你是从Git仓库拉取(pull)代码，GitLab Rails应用会全权负责处理用户鉴权和执行Git命令的工作；如果你是向Git仓库推送(push)代码，GitLab Rails应用既不会进行用户鉴权也不会执行Git命令，它会把以下工作交由GitLab Shell进行处理：

调用GitLab Rails API
检查权限执行pre-receive钩子（在GitLab企业版中叫做Git钩子）
执行你请求的动作
处理GitLab的post-receive动作
处理自定义的post-receive动作

5、GitLab Workhorse

GitLab Workhorse是一个敏捷的反向代理。它会处理一些大的HTTP请求，比如文件上传、文件下载、Git push/pull和Git包下载。其它请求会反向代理到GitLab Rails应用，即反向代理给后端的unicorn。

二、Gitlab 的安装

1、安装和配置必要的依赖关系

yum install -y curl policycoreutils-python openssh-server openssh-clients

2、添加 Gitlab 仓库

新建/etc/yum.repos.d/gitlab-ce.repo，内容为

[gitlab-ce]
name=Gitlab CE Repository
baseurl=https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el$releasever/
gpgcheck=0
enabled=1

3、安装 Gitlab (Omnibus方式)

yum makecache
EXTERNAL_URL="http://git.wzlinux.com" yum install -y gitlab-ce

注：EXTERNAL_URL 指定访问的域名。如何安装其他版本，可以通过清华大学源选择对应版本：http://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/ 。

4、配置启动

gitlab-ctl reconfigure

三、Gitlab 管理

1、Gitlab备份

使用 Gitlab 一键安装包安装 Gitlab 非常简单, 同样的备份恢复与迁移也非常简单. 使用一条命令即可创建完整的Gitlab 备份:

gitlab-rake gitlab:backup:create

使用以上命令会在/var/opt/gitlab/backups目录下创建一个名称类似为1481598919_gitlab_backup.tar的压缩包, 这个压缩包就是 Gitlab 整个的完整部分, 其中开头的：1481598919是备份创建的日期，/etc/gitlab/gitlab.rb配置文件须备份，/var/opt/gitlab/nginx/conf nginx配置文件，/etc/postfix/main.cfpostfix 邮件配置备份。

2、Gitlab恢复

Gitlab的从备份恢复也非常简单:

# 停止相关数据连接服务
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq

# 从1481598919编号备份中恢复
gitlab-rake gitlab:backup:restore BACKUP=1481598919

# 启动Gitlab
sudo gitlab-ctl start

3、Gitlab自动备份

实现每天凌晨2点进行一次自动备份:通过crontab使用备份命令实现

0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create

四、Gitlab的使用

Git global setup

git config --global user.name "wzlinux"
git config --global user.email "admin@wzlinux.com"

Create a new repository

git clone http://git.wzlinux.com/ios/app1.git
cd app1
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master

Existing folder

cd existing_folder
git init
git remote add origin http://git.wzlinux.com/ios/app1.git
git commit -m "Initial commit"
git push -u origin master

Existing Git repository

cd existing_repo
git remote add origin http://git.wzlinux.com/ios/app1.git
git push -u origin --all
git push -u origin --tags

五、Gitlab 的升级

因为我们使用 Omnibus GitLab package 进行安装，所以我们的升级相对比较简单，也建议大家使用这种方式安装，我目前的版本是10.0.4要升级到11.2.3，这算是大版本升级，根据官方文档的要求，我们需要先升级到10.x的最高版本。

参考文档：https://docs.gitlab.com/omnibus/update/README.html#version-specific-changes 。

1、升级过渡版本 10.8.7

升级过程中会对数据进行自动备份，不用担心数据安全。

# 下载对应版本的 rpm 包
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-10.8.7-ce.0.el7.x86_64.rpm

# 安装此过渡版本
rpm -Uvh gitlab-ce-10.8.7-ce.0.el7.x86_64.rpm

2、升级最新版本 11.2.3

# 下载最新版本的 rpm 包
wget https://mirrors.tuna.tsinghua.edu.cn/gitlab-ce/yum/el7/gitlab-ce-11.2.3-ce.0.el7.x86_64.rpm

# 安装最新版本
rpm -Uvh gitlab-ce-11.2.3-ce.0.el7.x86_64.rpm

#升级过程
warning: gitlab-ce-11.2.3-ce.0.el7.x86_64.rpm: Header V4 RSA/SHA1 Signature, key ID f27eab47: NOKEY
Preparing...                          ################################# [100%]
gitlab preinstall: Automatically backing up only the GitLab SQL database (excluding everything else!)
Dumping database ... 
Dumping PostgreSQL database gitlabhq_production ... [DONE]
done
Dumping repositories ...
[SKIPPED]
Dumping uploads ... 
[SKIPPED]
Dumping builds ... 
[SKIPPED]
Dumping artifacts ... 
[SKIPPED]
Dumping pages ... 
[SKIPPED]
Dumping lfs objects ... 
[SKIPPED]
Dumping container registry images ... 
[DISABLED]
Creating backup archive: 1535946629_2018_09_03_10.8.7_gitlab_backup.tar ... done
Uploading backup archive to remote storage  ... skipped
Deleting tmp directories ... done
done
Deleting old backups ... skipping
Updating / installing...
   1:gitlab-ce-11.2.3-ce.0.el7        #############################     ( 87%)
......
......

     _______ __  __          __
    / ____(_) /_/ /   ____ _/ /_
   / / __/ / __/ /   / __ `/ __ \
  / /_/ / / /_/ /___/ /_/ / /_/ /
  \____/_/\__/_____/\__,_/_.___/
  

Upgrade complete! If your GitLab server is misbehaving try running
  sudo gitlab-ctl restart
before anything else.
If you need to roll back to the previous version you can use the database
backup made during the upgrade (scroll up for the filename).