通过备份文件恢复/迁移 gitlab

拼搏现实的明天。 2022-05-20 05:12 418阅读 0赞

通过之前的记录，已经掌握了gitlab的本地备份和远程备份。

但是获取备份文件不是我们的目的，最终是为了通过备份文件实现迁移或恢复gitlab。本篇就是记录如何通过备份文件在新的环境上去恢复/迁移gitlab。

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

一、环境准备

首先在新服务器(192.168.2.1)上搭建gitlab，部署过程可以参考前面

注意：通过备份文件恢复gitlab必须保证新的gitlab版本必须要和老的gitlab版本一致，否则会提示版本不匹配。

![901201-20171020223053849-1449190385.png][]

所以无非是两种思路，一种将老的gitlab先升级到你要的gitlab版本，再迁移备份；另一种将gitlab安装的版本和老gitlab一致，迁移完成后再进行升级。

我采取先保持一致后迁移，再进行升级。

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

二、配置新的gitlab

gitlab的配置文件（gitlab.rb）是不因备份恢复而恢复的，故要将老的gitlab的配置文件也取过来，否则就需要维护人员重新配置。

2.1 获取gitlab.rb

在新服务器上，使用scp命令将老服务器（192.168.1.1）的备份文件复制到/etc/gitlab/目录下。

scp root@192.168.1.1:/etc/gitlab/gitlab.rb /etc/gitlab/gitlab.rb

![901201-20171020224115381-451024879.png][]

第一次连接时会询问是否要继续连接，输入yes，回车。

接着输入老服务器的root密码后，回车。

接着就会看到备份文件传输的信息。

![901201-20171020224336131-1464364386.png][]

2.2 修改external\_url

如果新gitlab服务器部署之后ip不改回老的ip（示例为192.168.1.1），故需要修改gitlab.rb的external\_url参数，因为页面上项目的http地址就是根据该参数拼接而成的。

![901201-20171020224721615-848686906.png][]

以新gitlab服务器的ip为192.168.2.1为例，修改gitlab配置文件。

vim /etc/gitlab/gitlab.rb

修改external\_url，wq保存。

external_url 'http://192.168.2.1'

2.3 重新配置gitlab

gitlab-ctl reconfigure

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

三、获取备份文件

在新服务器上，使用scp命令将老服务器（192.168.1.1）的备份文件（1508412719\_2017\_10\_19\_10.0.2\_gitlab\_backup.tar）复制到/var/opt/gitlab/backups/目录下。

scp root@192.168.1.1:/var/opt/gitlab/backups/1508412719_2017_10_19_10.0.2_gitlab_backup.tar /var/opt/gitlab/backups/

获取到/var/opt/gitlab/backups/目录下是因为我没有特别更换gitlab的备份目录，如果gitlab.rb有指定别的目录，根据实际情况自行修改。

![901201-20171020225527349-1415095985.png][]

第一次连接时会询问是否要继续连接，输入yes，回车。

接着输入老服务器的root密码后，回车。

接着就会看到备份文件传输的信息。

![901201-20171020225606677-1365751370.png][]

如果老服务器出现故障时，云端有备份文件可以从云端获取，比如云端192.168.1.2的/gitlab-backup目录下有备份文件，可以从那获取。

scp root@192.168.1.2:/gitlab-backup/1508412719_2017_10_19_10.0.2_gitlab_backup.tar /var/opt/gitlab/backups/

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

四、恢复/迁移gitlab数据

4.1 修改备份文件权限

将备份文件的权限改为777，否则恢复的时候会出现权限不够导致解压失败的问题。

![901201-20171020232711099-1357592912.png][]

chmod 777 /var/opt/gitlab/backups/1508412719_2017_10_19_10.0.2_gitlab_backup.tar

4.2 停止相关数据连接服务

gitlab-ctl stop unicorn
    gitlab-ctl stop sidekiq

4.3 恢复gitlab

使用“gitlab-rake gitlab:backup:restore BACKUP=备份文件编号”指令可以根据备份文件来恢复，因为示例中是使用1508412719\_2017\_10\_19\_10.0.2\_gitlab\_backup.tar来恢复，故备份文件编号为1508412719\_2017\_10\_19\_10.0.2。

gitlab-rake gitlab:backup:restore BACKUP=1508412719_2017_10_19_10.0.2

等待片刻后，由于新的gitlab还是处于初始状态，直接输入“yes”，回车。

![901201-20171020230648177-1723009903.png][]

然后就是等待恢复的结束。

到了下面的内容时，输入“yes”，回车。

![901201-20171020230735631-258598024.png][]

4.4 启动gitlab

gitlab-ctl start

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

五、关于本地备份和远程备份

由于这两块是额外配置的，如果新环境中也要有这一套备份机制，自然需要维护人员手动配一次。

[901201-20171020223053849-1449190385.png]: /images/20220520/4c0f9a79e51c49b5b1b6482cacbfd7e6.png
[901201-20171020224115381-451024879.png]: /images/20220520/4e13dc77ad66418183720cb03fae7622.png
[901201-20171020224336131-1464364386.png]: /images/20220520/79a763e7a3ea4b6c94f9159aece6e0e0.png
[901201-20171020224721615-848686906.png]: /images/20220520/007d968be13f488c9f23481651968af0.png
[901201-20171020225527349-1415095985.png]: /images/20220520/eb4e898d691a47809e6f2ebd674c03c0.png
[901201-20171020225606677-1365751370.png]: /images/20220520/9052194bebd44d1aa8aefaa39bccea91.png
[901201-20171020232711099-1357592912.png]: /images/20220520/14fd5702ce3c40f98911e13a4d48a7b8.png
[901201-20171020230648177-1723009903.png]: /images/20220520/5a4672ae66de46ba93b808bdcdf468a0.png
[901201-20171020230735631-258598024.png]: /images/20220520/8960007c5cbd47a3b38a1152e1f10683.png