迁移gitlab至docker容器过程与一些坑!

 

以下操作皆在root用户下, 话不多说, 直接开干

 

第一步: 备份原gitlab

进入gitlab目录下, 我这边是: /home/git/gitlab

执行命令: sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production

备份完成后会在: /home/git/gitlab/tmp/backups 下产生一个备份的压缩文件, 如: 1566977804_2019_08_28_9.5.3_gitlab_backup.tar (其中 9.5.3 代表gitlab的版本, 备份文件只能恢复到相同版本的gitlab服务中)

如果备份命令不起作用(可能是gitlab安装方式的区别), 请参考: http://blog.sina.com.cn/s/blog_6ff7a3b50102w3oj.html

 

第二步: 安装docker

centos7安装方式: yum install docker    (centos6请自行搜索安装docker方式)

启动docker服务: service docker start

 

第三步: 寻找合适的gitlab镜像

进入docker镜像官网搜索gitlab: https://hub.docker.com/r/gitlab/gitlab-ce/tags

根据刚才备份文件名中的版本号, 在tag列表中找到对应的镜像版本

记下tag名字, 我这里是: 9.5.3-ce.0   (一会拉取镜像时有用)

 

第四步: 拉取镜像

执行命令: docker pull docker.io/gitlab/gitlab-ce:9.5.3-ce.0    (冒号后面就是刚刚找到的对应版本号)

拉取完成后, 执行命令:  docker images    (查看本地镜像列表, 正常的话列表中出现gitlab镜像)

 

第五步: 在宿主机上准备3个挂载目录

mkdir -p /home/docker/gitlab/config

mkdir -p /home/docker/gitlab/data

mkdir -p /home/docker/gitlab/logs

开放挂载目录权限: chmod -R 777 /home/docker/gitlab

 

第六步: 使用gitlab镜像启动容器

几个坑:

1.如果宿主机的ssh远程登入端口为22的话, 最好将其修改为其他端口, 如: 2200 (否则gitlab安装完成后, 无法正常使用项目中的ssh地址进行clone/pull/push等操作) , 修改ssh端口的方案参考: https://www.cnblogs.com/rwxwsblog/p/5756894.html

2.启动容器时使用的映射端口需要确保没有被占用, 否则将无法正常访问, 查看当前服务器监听的端口列表命令:  netstat -lnpt

3.确保映射的宿主机端口是开放的(1.服务器防火墙  2.阿里云安全组策略), 修改防火墙参考: https://www.linuxidc.com/Linux/2019-06/159104.htm

执行命令: docker run --name='gitlab' -d --publish 22:22 --publish 1443:443 --publish 18080:80 --restart always --privileged=true --volume /home/docker/gitlab/config:/etc/gitlab --volume /home/docker/gitlab/logs:/var/log/gitlab --volume /home/docker/gitlab/data:/var/opt/gitlab  <本地gitlab镜像id>

执行命令: docker ps -a   (查看docker当前容器列表, 正常的话可以看到一个 gitlab 容器, 并且状态为 Up)

 

第七步: 测试gitlab服务运行状态

回到线下环境使用浏览器访问:  http://宿主机ip:18080 , 看到如下界面代表服务启动正常 (如果无法访问或者显示 502, 可能还在启动过程中, 稍等1分钟再刷新试试)

 

 

第八步: 使用在gitlab容器中恢复备份文件

首先将备份文件上传至宿主机 /home/docker/gitlab 目录下

执行命令: cp /home/docker/gitlab/备份文件名 /home/docker/gitlab/data/backups/ 

查看gitlab容器id:  docker ps -a 

进入容器: docker exec -it <容器id> /bin/bash

执行恢复: gitlab-rake gitlab:backup:restore BACKUP=1566977804_2019_08_28_9.5.3  force=yes   (其中橙色字体部分为备份文件名前缀, 这里文件名为: 1566977804_2019_08_28_9.5.3_gitlab_backup.tar)

简直不敢信, 竟然没有报错...

 

第九步: 查看恢复数据

回到线下浏览器, 再次访问 http://宿主机ip:18080

使用原有的git账号登入

登入成功, 看到了所有项目! 太感动了...

但是问题随之而来:

进入项目首页时, 看到 clone 地址中的hostname变成了一串 随机字符, 如: git@s4fad15gs1a:xxxxxx/xxxxx.git (理想中应该是: git@git.xxx.com:xxxxx/xxxx.git), 并且无法使用此链接 clone 代码

处理方案: 

进入容器: docker exec -it <容器id>  /bin/bash

编辑配置文件: vi /etc/gitlab/gitlab.rb 

　　找到 external_url , 取消注释, 并修改为 external_url  'http://服务器的ip或域名'

　　找到 gitlab_rails['gitlab_ssh_host'], 取消注释, 并修改为 gitlab_rails['gitlab_ssh_host'] = '服务器的ip或域名'

　　保存

更新配置:  gitlab-ctl reconfigure

重新启动:  gitlab-ctl restart

等待1分钟启动完成后, 再次回到线下查看, 发现地址对了

 

第十步: 测试clone项目

在本地机器上新建一个文件夹, 进入文件夹, 右键调出 Git Bash

执行: git clone git@git.flow360.cn:cardmee/page_pc.git

结果报错..

由于服务器的更改, 原有的 ssh 授权信息已经失效了, 需要 找到 known_hosts 文件, 将里面原来的 授权记录一行删除, 保存

保存后再次执行 git clone git@git.flow360.cn:cardmee/page_pc.git

询问授权输入 yes , 回车

正常下载代码中....

 

最后2个坑:

1. 我刚刚为了修改clone地址, 改了gitlab.rb文件, 然而当我重启容器后, 修改的配置又回到了默认状态, 这就很操蛋了...

解决方案: 

在宿主机下进入目录: cd /home/docker/gitlab/config 

以同样的方式修改 gitlab.rb 文件, 保存

重启gitlab容器: docker restart <容器id>

测试通过

 

2.gitlab占用内存过高的优化

解决方案: 

在宿主机下进入目录: cd /home/docker/gitlab/config 

修改 gitlab.rb 文件

　　找到 unicorn['worker_processes'] , 取消注释, 修改为 unicorn['worker_processes'] = 2

　　找到 unicorn['worker_memory_limit_min'] , 取消注释, 修改为 unicorn['worker_memory_limit_min'] = "200 * 1 << 20"

　　 找到 unicorn['worker_memory_limit_max'], 取消注释, 修改为 unicorn['worker_memory_limit_max'] = "300 * 1 << 20"

　　 找到 sidekiq['concurrency'] , 取消注释, 修改为 sidekiq['concurrency'] = 5

　　找到 postgresql['shared_buffers'] , 取消注释, 修改为 postgresql['shared_buffers'] = "128MB"

保存

重启容器: docker restart <容器id>