Gitlab 备份和恢复

gitlab可以算作公司最重要的知识资产之一，虽然由于其设计，每个开发本地可能都存在着负责项目的全部提交记录，但一旦gitlab发生故障，轻则浪费大量时间进行项目重建，重则丢失项目代码数据。未雨绸缪，提前进行gitlab备份和数据恢复演练，本文记录gitlab的定时备份方案和数据恢复操作。

备份脚本

使用crontab设置定时任务，每天凌晨2点执行备份脚本

crontab -l
0 2 * * * /opt/gitlab_backup.sh
1
2

脚本内容如下所示，其中：

1. /var/opt/gitlab/backups/ 为gitlab 备份文件地址
2. gitlab-rake gitlab:backup:create 为备份命令
3. /mnt/remote/git/ 为挂载的网盘，或者nas，或者使用scp命令传输到远程服务器

#!/bin/sh
scp_linux_path='/var/opt/gitlab/backups/'
cp_local_uri='/mnt/remote/git/'
scp_log_path='/opt/gitlab_backup.log'

time=$(date +%Y-%m-%d\ %H:%M:%S)
gitlab-rake gitlab:backup:create
filename=`ls $scp_linux_path -t |head -n1|awk '{print $0}'`
echo [$time] $scp_linux_path$filename >> $scp_log_path
cp $scp_linux_path$filename $cp_local_uri

# 清理历史旧备份文件
delfile=`ls -l -crt  $scp_linux_path/*.tar | awk '{print $9 }' | head -1`
count=`ls -l -crt  $scp_linux_path/*.tar | awk '{print $9 }' | wc -l`
echo "total count $count" >> /opt/gitlab_backup.log
if [ $count -gt 6 ]
then
    rm $delfile
    echo "delete $delfile" >> /opt/gitlab_backup.log
fi
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

此外，还需要手动备份/etc/gitlab/gitlab.rb和/etc/gitlab/gitlab-secrets.json 文件, 在恢复数据时需要使用。

恢复步骤

原gitlab未使用docker，安装部署太繁琐，新的备份gitlab使用docker进行部署，步骤记录如下。

1. gitlab-rake gitlab:env:info 查看gitlab版本号(或者直接在gitlab页面查看)
2. 在docker hub找到对应的镜像版本
3. docker pull gitlab/gitlab-ce:13.0.3-ce.0 根据被备份的gitlab版本下载镜像
4. 启动容器

   docker run \
   -itd \
   -p 10000:80 \
   -p 2222:22 \
   -v /root/soft/gitlab/etc:/etc/gitlab \
   -v /root/soft/gitlab/log:/var/log/gitlab \
   -v /root/soft/gitlab/opt:/var/opt/gitlab \
   --restart always \
   --privileged=true \
   --name gitlab \
   gitlab/gitlab-ce:13.0.3-ce.0
   1
   2
   3
   4
   5
   6
   7
   8
   9
   10
   11

5. 访问http://ip:10000 , 根据提示输入新密码，登录，确认可以访问
6. 将最新的备份包1695143223_2023_09_20_13.0.3_gitlab_backup.tar 包拷贝到/root/soft/gitlab/opt/backups/ (映射到容器内的/var/opt/gitlab/backups/)目录
7. docker exec -it gitlab bash进入gitlab容器，执行命令

   # 关闭相关服务
   gitlab-ctl stop unicorn    
   gitlab-ctl stop sidekiq
   # 进入目录，修改权限
   cd /var/opt/gitlab/backups
   chmod 777 1695143223_2023_09_20_13.0.3_gitlab_backup.tar
   chown git.git 1695143223_2023_09_20_13.0.3_gitlab_backup.tar
   # 恢复备份数据
   gitlab-backup restore BACKUP=1695143223_2023_09_20_13.0.3
   # 根据提示输入yes 回车确认
   1
   2
   3
   4
   5
   6
   7
   8
   9
   10

8. 将备份的(gitlab.rb 和) gitlab-secrets.json 文件拷贝到/root/soft/gitlab/etc (映射到容器内/etc/gitlab/)目录
9. docker restart gitlab 重启
10. docker logs -f gitlab 观察日志，没有异常且启动成功后再访问http://ip:10000，登录验证，发现数据已恢复