发布于 

Gitlab 备份和恢复

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

备份脚本

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

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

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

  1. /var/opt/gitlab/backups/ 为gitlab 备份文件地址
  2. gitlab-rake gitlab:backup:create 为备份命令
  3. /mnt/remote/git/ 为挂载的网盘，或者nas，或者使用scp命令传输到远程服务器
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    #!/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

此外，还需要手动备份/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. 启动容器
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    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
  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容器，执行命令
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    # 关闭相关服务
    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 回车确认
  8. 将备份的(gitlab.rb 和) gitlab-secrets.json 文件拷贝到/root/soft/gitlab/etc (映射到容器内/etc/gitlab/)目录
  9. docker restart gitlab 重启
  10. docker logs -f gitlab 观察日志，没有异常且启动成功后再访问http://ip:10000，登录验证，发现数据已恢复
许可协议

本文采用 署名-非商业性使用-相同方式共享 4.0 国际 许可协议，转载请注明出处。

分享文章