gitLab数据备份和恢复

柔情只为你懂 2024-03-30 09:05 118阅读 0赞

自建的Gitlab服务器常常会因为使用时间的增长，其空间容量等硬件需求都需要升级，或者迁移至更高配置的服务器上。备份、迁移、恢复、升级过程如下

### 一、gitlab备份 ###

#### 1、修改仓库存储位置 ####

gitlab通过rpm包安装后，默认存储位置在/var/opt/gitlab/git-data/repositories，通常需要更改此路径到单独的一个分区来存储仓库的数据。

这里我把数据存放到/home/gitlab-data目录下

mkdir -p 即使上级目录不存在，会按目录层级自动创建目录

mkdir -p /home/gitlab-data

修改gitlab配置文件，找到git\_data\_dir

vim /etc/gitlab/gitlab.rb

![5ab3c1f8d24249f2b3d6adc96f1b5fe4.png][]

重新加载配置

sudo gitlab-ctl reconfigure

重新加载后，会发现在/home/git-data目录下多出一个repositories目录

重启

sudo gitlab-ctl restart

#### 2、修改备份文件目录 ####

备份的位置可以更换,使用如下命令：(默认可以不修改,那么默认生成在/var/opt/gitlab/backups)
    可以通过/etc/gitlab/gitlab.rb配置文件来修改默认存放备份文件的目录
    vim /etc/gitlab/gitlab.rb

![49e3b8d365ff4af68ef09f61deb06e21.png][]

取消注释并修改为自定义备份路径 gitlab\_rails\['backup\_path'\] = "/home/gitlab-backups"  
重读配置

sudo gitlab-ctl reconfigure

重启

sudo gitlab-ctl restart

#### 3、通过gitlab-rake命令备份gitlab ####

备份时需要保持gitlab处于正常运行状态，直接执行gitlab-rake gitlab:backup:create进行备份(需要sudo权限,不然报错)
    gitlab提供的备份命令为gitlab-rake，备份命令使用如下:
    sudo gitlab-rake gitlab:backup:create
     
    使用以上命令会在/var/opt/gitlab/backups目录下创建一个名称类似为1530156812\_2018\_06\_28\_10.8.4\_gitlab\_backup.tar的压缩包,
    这个压缩包就是Gitlab整个的完整部分, 其中开头的1530156812\_2018\_06\_28\_10.8.4是备份创建的日期;

该命令会备份gitlab仓库、数据库、用户、用户组、用户密钥、权限等信息。  
备份完成后备份文件会出现在/var/opt/gitlab/backups/

![089f7b372c1c4dbb9ba3b3b3956268ea.png][]

红字部分表示 gitlab.rb 和 gitlab-secrets.json 两个文件包含敏感信息。未被备份到备份文件中。需要手动备份。

这两个文件在/etc/gitlab/ 目录下，我们进入目录使用cp命令复制到自定义的备份目录

cp gitlab.rb   gitlab-secrets.json  /home/gitlab-backups/

#### 4、设置备份过期时间 ####

[root@gitlab ~\]# vim /etc/gitlab/gitlab.rb
    gitlab\_rails\['backup\_keep\_time'\] = 604800        #以秒为单位

#### 5、自动备份方案 ####

创建定时任务
    [root@gitlab ~\]# crontab -e
    0 2 \* \* \* /opt/gitlab/bin/gitlab-rake gitlab:backup:create

![3630bf9fce884066b7e3d604f33482d2.png][]

> minute： 表示分钟，可以是从0到59之间的任何整数。  
> hour： 表示小时，可以是从0到23之间的任何整数。  
> day： 表示日期，可以是从1到31之间的任何整数。  
> month： 表示月份，可以是从1到12之间的任何整数。  
> week： 表示星期几，可以是从0到7之间的任何整数，这里的0或7代表星期日。  
> command：要执行的命令，可以是系统命令，也可以是自己编写的脚本文件。

> 在书写 crontab 定时任务时，需要注意以下几个事项：  
> 1、6 个选项都不能为空，必须填写。如果不确定，则使用"\*"代表任意时间。  
> 2、crontab 定时任务的最小有效时间是分钟，最大有效时间是月。像 2018 年某时执行、3 点 30 分 30 秒这样的时间都不能被识别。  
> 3、在定义时间时，日期和星期最好不要在一条定时任务中出现，因为它们都以天为单位，非常容易让管理员混淆。  
> 4、在定时任务中，不管是直接写命令，还是在脚本中写命令，最好都使用绝对路径。有时使用相对路径的命令会报错。

方法1.每天自动备份gitlab，并只保留近7天备份

编辑备份脚本vim /var/opt/gitlab/gitbackup.sh
    # !/bin/bash
    gitlab-rake gitlab:backup:create CRON=1
    将该脚本加入crontab中执行，每天凌晨1点备份
    crontab -e：                                        //进入crontab编辑模式
    0 1 * /var/opt/gitlab/gitbackup.sh &>/dev/null
    vim /etc/gitlab/gitlab.rb
    找到gitlab_rails['backup_keep_time'] = 604800取消注释,
    gitlab-ctl reconfigure     重读配置
    gitlab-ctl restart         重启

方法2.以实现每天凌晨4点进行一次自动备份为例，系统的crontab配置如下:

vim /etc/crontab
    0 4 * * * root /opt/gitlab/bin/gitlab-rake gitlab:backup:create CRON=1

然后重启crontab服务，如下：

systemctl restart crond

--------------------

### 二、gitlab仓库恢复 ###

要验证gitlab备份的有效性，我们可以把该备份文件复制到已经安装好gitlab服务器的/var/opt/gitlab/backups/目录下。
    然后进行数据恢复，最后访问并查看其数据完整性即可。
    通过gitlab备份文件可以恢复gitlab所有的信息，包括仓库、数据库、用户、用户组、用户密钥、权限等信息。
    ps：新服务器上的gitlab的版本号必须与创建备份时的gitlab版本号相同。
    gitlab数据恢复比较简单，具体步骤如下：

1、停止相关数据连接服务

gitlab-ctl stop unicorn
    gitlab-ctl stop sidekiq

2、恢复gitlab仓库

进入/var/opt/gitlab/backups  
现在我们要从1537261122\_2018\_09\_18\_9.2.5这个备份编号中，恢复数据，命令如下：

gitlab-rake gitlab:backup:restore BACKUP=1546916920_2019_01_08_10.5.1

按照提示输入两次yes并回车

如果出现多个done的信息，说明整个gitlab数据就已经正常恢复完毕。

4、恢复两个配置文件

我们进入备份目录使用cp命令复制到配置目录

cp gitlab.rb   gitlab-secrets.json  /etc/gitlab/

5、恢复完毕以后，我们现在来启动gitlab，使用以下命令：

gitlab-ctl start

--------------------

### 三、gitlab迁移 ###

迁移的整体思路是：  
1、在新服务器上安装相同版本的gitlab  
2、将备份生成的备份文件发送到新服务器的相同目录下

这里在10.0.0.6的机器上安装了相同版本的gitlab并能正常运行使用

![27f8555a0e844e02800ae6fa35fa8087.png][]

在老服务器上将备份文件发送至新服务器的相应目录下，然后在使用恢复命令即可

[5ab3c1f8d24249f2b3d6adc96f1b5fe4.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/805fe929f8e94a22a3ddb03496f0e0bb.png
[49e3b8d365ff4af68ef09f61deb06e21.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/a2a4c04ad94c45b0ac17246bcd284b95.png
[089f7b372c1c4dbb9ba3b3b3956268ea.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/92f46ba207da4f47916ad44f18eadac5.png
[3630bf9fce884066b7e3d604f33482d2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/ab2952553bc345528e5ad9a7c38a9961.png
[27f8555a0e844e02800ae6fa35fa8087.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/a4734067fd6449eaa4d44335fd3b61b9.png