GitLab数据迁移

一、需求说明

公司原GitLab搭建在192.168.113.7机器上，采用yum安装；现需要将GitLab迁移到192.168.113.53机器上并以Docker方式进行部署，需要保证数据的一致。

二、准备工作

在原GitLab主机中备份数据：
```
gitlab-rake gitlab:backup:create RAILS_ENV=production
```
备份后的文件一般是位于/var/opt/gitlab/backups下, 自动生成文件名如：1605236222_2020_11_13_11.9.8_gitlab_backup.tar

查看GitLab版本

方式一：登录到GitLab页面，点击头像左边"帮助"，可以在页面中查看GitLab版本；

方式二：在安装GitLab的主机上执行以下命令，同样能获取到GitLab的版本号

[root@root7 ~]# gitlab-rake gitlab:env:info

System information
System:		
Current User:	git
Using RVM:	no
Ruby Version:	2.5.3p105
Gem Version:	2.7.6
Bundler Version:1.16.6
Rake Version:	12.3.2
Redis Version:	3.2.12
Git Version:	2.18.1
Sidekiq Version:5.2.5
Go Version:	unknown

GitLab information
Version:	11.9.8
Revision:	48528bc
Directory:	/opt/gitlab/embedded/service/gitlab-rails
DB Adapter:	postgresql
URL:		http://gitlab.example.com
HTTP Clone URL:	http://gitlab.example.com/some-group/some-project.git
SSH Clone URL:	git@gitlab.example.com:some-group/some-project.git
Using LDAP:	no
Using Omniauth:	yes
Omniauth Providers: 

GitLab Shell
Version:	8.7.1
Repository storage paths:
- default: 	/var/opt/gitlab/git-data/repositories
GitLab Shell path:		/opt/gitlab/embedded/service/gitlab-shell
Git:		/opt/gitlab/embedded/bin/git

在另外一台机器上，利用docker-compose部署GitLab，需要注意的是，新安装的GitLab需要和原GitLab保持一致的版本，因为高版本的GitLab无法恢复低版本备份的数据。docker-compose部署GitLab教程

docker-compose.yml示例:

version: '3'
services:
  gitlab:
    image: 'gitlab/gitlab-ce:11.9.8-ce.0'
    container_name: gitlab
    restart: always
    environment:
      GITLAB_OMNIBUS_CONFIG: |
        external_url 'http://192.168.113.53'
        gitlab_rails['gitlab_shell_ssh_port'] = 2224
    ports:
      - '80:80'
      - '2224:22'
    volumes:
      - './config:/etc/gitlab'
      - './logs:/var/log/gitlab'
      - './data:/var/opt/gitlab'

与教程中yml文件有所不同，因为原GitLab采用80端口，所以这里也采用80端口，

利用docker-compose命令进行编排，当容器成功启动之后，将第一步中准备好的tar包拷贝到数据映射目录下的backups目录当中

执行docker-compose up -d命令之后，在浏览器中输入ip:端口，若出现了设置新密码页面，不需要在页面中设置新密码，因为后面还需要进行数据恢复，所以不用设置新密码；出现设置密码页面说明GitLab已部署成功，可以进行下一步。
```
[root@localhost backups]# pwd
/home/work/docker-gitlab/data/backups
[root@localhost backups]# ls
1605236222_2020_11_13_11.9.8_gitlab_backup.tar  tmp
```
进入GitLab容器当中，执行以下命令恢复tar包中的数据：
```
gitlab-rake gitlab:backup:restore RAILS_ENV=production BACKUP=1605236222_2020_11_13_11.9.8
```
BACKUP后的时间点要和原GitLab中导出的tar包保持一致，执行命令后，中途会让你选择yes/no，一路yes即可，当命令执行结束之后，在浏览器中输入迁移后GitLab的ip:端口，用原GitLab中的用户可以正常登录，且项目数据都在其中。至此，GitLab迁移结束。