Gitlab使用国内镜像安装、备份及迁移

一、Gitlab 安装

1. 环境准备

本教程主要以 CentOS 7为主,其他系统请查看官方文档对比。

1. 安装和打开 http 和 ssh 的权限
sudo yum install -y curl policycoreutils-python openssh-server
sudo systemctl enable sshd
sudo systemctl start sshd

sudo firewall-cmd --permanent --add-service=http
sudo systemctl reload firewalld

2. 安装邮件服务 postfix
sudo yum install postfix
sudo systemctl enable postfix
sudo systemctl start postfix

使用其他邮件服务,可以根据官方文档自行修改:
https://docs.gitlab.com/omnibus/settings/smtp.html

2. 镜像切换

Gitlab 国外镜像速度一向感人,而且是不是的还抽风,所以在国内搭建 Gitlab 使用的时候,还是切换成墙内镜像比较放心。目前官方支持的国内镜像是清华大学的镜像站,地址:https://mirror.tuna.tsinghua.edu.cn/help/gitlab-ce/

1. 新建镜像 repo

新建 /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
2. 执行命令下载
sudo yum makecache
sudo yum install gitlab-ce
3. 配置使用

安装完成之后,可以在/etc/gitblab/gitlab.rb中按照需求修改配置,
主要需要修改external_url,改成自己使用的 url 地址。
执行命令配置生效:

gitlab-ctl reconfigure

如果想使用已有的 nginx,或者相对 gitlab 内置 nginx 进行高级配置的话,可以参考官方文档:
https://docs.gitlab.com/omnibus/settings/nginx.html
例如,修改监听端口,增加 ssl 配置,设置 header:

nginx['listen_port'] = 8081
# For GitLab
nginx['ssl_certificate'] = "/etc/gitlab/ssl/gitlab.example.com.crt"
nginx['ssl_certificate_key'] = "/etc/gitlab/ssl/gitlab.example.com.key"
# proxy set header
nginx['proxy_set_headers'] = {
  "X-Forwarded-Proto" => "http",
  "CUSTOM_HEADER" => "VALUE"
 }

需要注意的是,修改配置之后,都需要执行gitlab-ctl reconfigure命令,使配置生效。

二、Gitlab 备份

Gitlab 成功运行起来之后,最终的事情就是定期的备份,遇到问题后的还原。

1. 备份配置

默认 Gitlab 的备份文件会创建在/var/opt/gitlab/backups文件夹中,格式为时间戳_日期_版本号_gitlab_backup.tar,例如:1515031353_2018_01_04_10.3.2_gitlab_backup.tar
修改备份文件夹,需要修改配置文件/etc/gitlab/gitlab.rb中的:

gitlab_rails['backup_path'] = '/your_wish/backups'

然后gitlabctl-reconfigure生效。

2. 手动备份

命令:gitlab-rake gitlab:backup:create
会在命令执行的时间点,在你配置的文件夹或者默认文件夹创建一个备份文件。

3. 自动备份

Gitlab 支持 crontab 来创建计划任务,执行命令:sudo crontab -e -u root,为 root 用户,创建并编辑 crontab。
例如,每周二到周六的早晨创建一个自己命名规则的备份:

15 04 * * 2-6  umask 0077; tar cfz /secret/gitlab/backups/$(date "+etc-gitlab-\%s.tgz") -C / etc/gitlab

crontab 可以参考:
http://www.pantz.org/software/cron/croninfo.html
更多备份用法,可以参考:
https://docs.gitlab.com/omnibus/settings/backups.html#backups

4. 恢复备份

先停止 gitlab 相关服务:

sudo gitlab-ctl stop unicorn
sudo gitlab-ctl stop sidekiq

执行备份恢复命令:

gitlab-rake gitlab:backup:restore BACKUP=1515031353_2018_01_04_10.3.2

为了防止有问题,还是需要执行重新配置,用来重新配置和启动:

gitlab-ctl reconfigure
5. 迁移,及版本不一致问题
Gitlab 迁移

Gitlab 的迁移非常简单,只需要在目标服务器上安装好之后,把 Gitlab 的备份文件放到备份目录中,然后执行上一步的恢复备份命令即可。

Gitlab 迁移版本不一致问题

但是Gitlab 有个不爽的地方就是,不同版本号的备份文件不能相互使用。有时候备份文件是旧版本,安装的时候自动安装了最新版本,这时候备份文件就没办法使用了,怎么办呢?

  1. 先卸载掉已经安装的最新版Gitlab:sudo yum remove gitlab-ce
  2. 在 Gitlab package 地址https://packages.gitlab.com/gitlab/gitlab-ce中找到对应操作系统和版本的安装包,例如 CentOS 7,Gitlab 10.3.1对应的是gitlab-ce-10.3.1-ce.0.el7.x86_64.rpm
    执行安装命令
curl -s https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.rpm.sh | sudo bash
sudo yum install gitlab-ce-10.3.1-ce.0.el7.x86_64 

然后重复之前的安装、配置、恢复备份的目录即可。

发表评论