当前位置：博创云素材 > 站长学院 > 技术文档 > docker下升级并迁移gitlab到最新版本或指定版本

docker下升级并迁移gitlab到最新版本或指定版本

作者 : 小优 本文共5537个字，预计阅读时间需要14分钟 发布时间： 2022-01-6 共531人阅读

最近查看公司使用的gitlab版本，是gitlab-ce:11.5.0-ce.0,而官方最新的稳定版本已经到了gitlab-ce:13.12.10-ce.0。正在要换服务器，所以趁这个机会迁移gitlab机器，并且把gitlab从11.5升级到13.12.10。

本次目标

使用docker把gitlab迁移到另外一台机器，从gitlab/gitlab-ce:11.5.0-ce.0升级到gitlab/gitlab-ce:13.12.10-ce.0

这里把老机器称为gitlab_old
把新机器称为gitlab_new

方案选择

在网上找的资料很多，有通过docker直接升级的，有通过deb包手动升级的，各种方式比较乱。

于是我决定以官方的升级方式为准，在gitlab官方文档找到以下文档：

docker安装升级文档：https://docs.gitlab.com/omnibus/docker/README.html
gitlab版本升级建议：https://docs.gitlab.com/ee/update/index.html#upgrading-to-a-new-major-version

查阅文档大致可以知道，gitlab每个月22号就会发布一个小版本(Minor版本)，每年5月22号会发布一个大版本(Major版本)。当出现跨版本升级，并不能一步到位，直接升级，需要先升级到对应最近的小版本，以及一些必须升级的版本，最终才能逐步升级到目标版本。

例如我这里是11.5.0 升级到 13.12.10,经过我的查阅和测试，我最终的升级路线是（后面解释为什么需要按路线升级）：

11.5.0 -> 11.11.8 -> 12.0.12 -> 12.1.17 -> 12.10.14 -> 13.0.14 -> 13.1.11 -> 13.8.8 -> 13.12.10

主要步骤

  • 1.从gitlab_old中备份出全量数据(开始备份的时候就通知开发人员gitlab不可用了，避免数据不一致)
  • 2.在gitlab_new上拉一个新的同版本的gitlab，导入数据
  • 3.基于gitlab_new上的同版本gitlab做升级，并且备份每一个版本
  • 4.测试

接下来就一步一步来完成

1.备份全量的gitlab数据

1.备份数据,登陆gitlab_old机器

docker exec -it gitlab-ce:11.5.0-ce.0 /bin/bash
cd /var/opt/gitlab/backups
# 执行备份命令
gitlab-rake gitlab:backup:create

可能报错ArgumentError: could not find a temporary directory
解决：给/var/opt/gitlab/backups/tmp赋权限
cd /var/opt/gitlab/backups 
chmod +t ./tmp

然后再执行
gitlab-rake gitalb:backup:create
导出的包在/data/gitlab/data/backup下面
21341666-a7822b4629afd470

2.把导出的包传到gitlab_new
在容器内/var/opt/gitlab/backups下面会有个这样的包1641435477_2022_01_06_11.5.0_gitlab_backup.tar，我对应容器外的目录是,/home/gitlab/data/backup。需要把这个包传到gitlab_new服务器，这个包很大，我的有20多g，如果通过scp传包，那估计传到好几个小时不一定搞得定。所以这里选择使用lz4传包。21个g我这里大概需要20分钟。

在gitlab_old上
#切换到目录
cd /data/gitlab/data/backup
#执行传包命令
tar -c 1641435477_2022_01_06_11.5.0_gitlab_backup.tar |pv|lz4 -B4|ssh -p10086 -c arcfour128 -o"MACs umac-64@openssh.com" 127.0.0.1 "lz4 -d |tar -xC /data" # 127.0.0.1应该改成gitlab_new的ip 如果上面命令报错，可能是以下几个原因： 1.没安装pv命令 解决：yum install -y pv 2.提示Cipher错误，因为ssh去掉了一些不安全的加密协议，例如上面用到的arcfour128 解决： vim /etc/ssh/sshd_config 在末尾新增一行：Ciphers 3des-cbc,aes128-cbc,aes192-cbc,aes256-cbc,aes128-ctr,aes192-ctr,aes256-ctr,aes128-gcm@openssh.com,aes256-gcm@openssh.com,arcfour,arcfour128,arcfour256,blowfish-cbc,cast128-cbc,chacha20-poly1305@openssh.com 重启sshd：service sshd restart 两边都加上，然后再运行传包命令，下图就是正在传包的样子。
21341666-e752d650e667b03e

2.拉取一个新的同版本的gitlab开始数据迁移

在gitlab_new机器上操作

1.首先拉取升级过程中每个需要的版本的gitlab镜像
docker pull gitlab/gitlab-ee:12.1.0-ee.0
docker pull gitlab/gitlab-ce:11.5.0-ce.0
docker pull gitlab/gitlab-ce:11.11.8-ce.0
docker pull gitlab/gitlab-ce:12.0.12-ce.0
docker pull gitlab/gitlab-ce:12.1.17-ce.0
docker pull gitlab/gitlab-ce:12.10.14-ce.0
docker pull gitlab/gitlab-ce:13.0.14-ce.0
docker pull gitlab/gitlab-ce:13.1.11-ce.0
docker pull gitlab/gitlab-ce:13.8.8-ce.0
docker pull gitlab/gitlab-ce:13.12.10-ce.0

由于之前的版本是gitlab-ce:11.5.0-ce.0，数据导入只能是同版本的，所以首先得在新机器上拉一个gitlab-ce:11.5.0-ce.0的gitlab

2.搭建同版本的gitlab

1.创建目录

mkdir -p /home/gitlab-ce:11.5.0-ce.0/data
mkdir -p /home/gitlab-ce:11.5.0-ce.0/config
mkdir -p /home/gitlab-ce:11.5.0-ce.0/logs

2.启动脚本

GITLAB_HOME=/home/gitlab-ce:11.5.0-ce.0
docker run -d 
--name gitlab-ce:11.5.0-ce.0 
--hostname git.xxx.com 
--publish 2443:443 --publish 18080:80 --publish 2221:22 
--restart always 
--volume $GITLAB_HOME/config:/etc/gitlab 
--volume $GITLAB_HOME/logs:/var/log/gitlab 
--volume $GITLAB_HOME/data:/var/opt/gitlab 
gitlab/gitlab-ce:11.5.0-ce.0

3.查看日志

docker logs  -f gitlab-ce:11.5.0-ce.0 日志正常不报错，就访问http://ip,说明搭建成功
21341666-2a92a175adf8e71c
3.数据和配置恢复
把之前从gitlab_old传过来的包移动到gitlab备份目录
mv /data/1601429376_2020_09_30_12.1.0-ee_gitlab_backup.tar /home/gitlab-ce:11.5.0-ce.0/data/backups/

进入容器，执行命令
docker exec -it gitlab-ce:11.5.0-ce.0 /bin/bash 
cd /var/opt/gitlab/backups/   --这里有备份文件
停应用
gitlab-ctl stop unicorn
gitlab-ctl stop sidekiq
开始恢复
gitlab-rake gitlab:backup:restore BACKUP=1641435477_2022_01_06_11.5.0
这里会卡很久，要有点耐心，需要确认的地方全部选yes，是备份ssh key之类的

如果报错没权限，就执行 chmod 777 1641435477_2022_01_06_11.5.0_gitlab_backup.tar，再执行备份命令

gitlab-ctl restart
gitlab-rake gitlab:check SANITIZE=true
退出容器，重启容器,观察日志
docker restart gitlab-ce:11.5.0-ce.0 
docker logs -f gitlab-ce:11.5.0-ce.0
此时就能正常访问同版本的gitlab了，但是还有两个问题
  • 第一个是进入项目setting -> cicd 页面报错500
  • 第二个是目前还是ip访问，但是之前是https域名访问
提前更换之前gitlab域名的解析，从gitlab_old解析到gitlab_new。

解决：由于通过tar包只能还原数据文件，配置都不能还原，所以这里首先需要去gitlab_old去拷贝gitlab.rb,gitlab-secrets.json这两个文件以及ssl这个放https整数的文件夹。
备份gitlab_new机器上的文件，然后把这三个放在对应的位置。然后在gitlab_new上重新加载配置：
docker exec -it gitlab-ce:11.5.0-ce.0 /bin/bash 
gitlab-ctl reconfigure
gitlab-ctl restart
退出容器，重启gitlab
docker restart gitlab-ce:11.5.0-ce.0

此时就能通过之前gitlab的域名去访问新机器搭建的gitlab了。完成了gitlab的机器迁移，然后就去在gitlab_new上进行gitlab升级。

21341666-5190d10f714cb712

gitlab升级

基于gitlab_new上的同版本gitlab做升级，并且备份每一个版本。我这里演示从11.5.0 升级到11.11.8

docker stop gitlab-ce:11.5.0-ce.0
GITLAB_HOME=/home/gitlab-ce:11.11.8-ce.0
docker run -d 
--name gitlab-ce:11.11.8-ce.0 
--hostname git.xxx.com 
--publish 2443:443 --publish 18080:80 --publish 2221:22 
--restart always 
--volume $GITLAB_HOME/config:/etc/gitlab 
--volume $GITLAB_HOME/logs:/var/log/gitlab 
--volume $GITLAB_HOME/data:/var/opt/gitlab 
gitlab/gitlab-ce:11.11.8-ce.0

这一步可以理解为gitlab在自动洗数据，由于之前数据和image的版本都是11.5.0，然后使用11.11.8的image去拉起，就会把数据洗成11.11.8版本的。如果说，数据是11.5.0版本，你直接用13.12.10的image去拉起，那么就会报错：数据和版本不兼容。所以需要逐步在版本兼容的数据和镜像之间去逐步完成数据的版本升级，这也是为什么，从11.5.0升级到13.12.10需要经历这么多image。

知道了这一点以后，就可以重复上面的操作，按最开始的路径，去升级到13.12.10。这里有一个建议，就是每个版本都保留一个备份。如图，保存每个数据版本，然后对应image版本拉取一个容器，这样就能在升级过程中随时去切换，每个版本都是能独立启动的。

21341666-a17a7ea0f9ea0044
这里注意：
当我们备份数据的数据，使用cp -rpf 
例如我这个目录gitlab-12.1.0.ee，用12.10.14的景象拉过，我就这样备份：
cp -rpf gitlab-ce:11.5.0-ce.0  gitlab-ce:11.11.8-ce.0 
-p 命令能够连带文件夹权限一起复制，否则，你复制后拉取容器的时候，就会提示权限错误。

然后我重复以上操作，最终就把gitlab从11.5.0升级到13.12.10

测试

我主要测试了以下几个方面

  • 1.检查之前项目是否都还在
  • 2.拉代码，推代码
  • 3.ci-cd是否还能正常执行
  • 4.以前文档和wiki内容是否还有

我这里更换了机器，所以域名对应的ip更改了，这里有一个问题，就是pull代码会报错，是因为我们的域名更换了网址，然后在我们本地know_hosts中有之前ip的缓存，所以key识别失败。

解决：
cat ~/.ssh/known_hosts
把之前域名对应ip的缓存删掉

我这里是mac系统，如果是windows系统，就去找对应known_hosts文件的位置

总结

  • 升级方案主要还是得参考官网
  • 注意备份每个版本，可能升级到中间版本会出现问题，这样可以从上个版本着手解决，不然只能从头开始。
  • 整个升级过程，应该让使用gitlab的人没什么感知，我这里由于换了机器，所以需要让其他开发删除一下本地known_hosts，其他就和之前使用一样

 

资源下载说明

请使用百度网盘下载资源，请不要在线解压！

1.人民币与U币汇率为1比10,即1元=10U币.有任何疑问请联系客服处理！
2.请记住本站永久网址发布页：http://uuscw.com
3.本站资源大多存储在云盘，如发现链接失效请在下方评论留言，作者看到后会第一时间更新补链。
4.关于解压密码错误或者资源损坏，请查看解压教程：[必看]关于资源教程及常见问题
5.本站大部分资源解压密码均为: uuscw.com 如密码有误，请查看原帖的资源说明！

免责申明：
 1.如果服务器暂不能下载请稍后重试！总是不能下载，请联系客服,谢谢合作！
2.本站所有资源（包括写真、模板、素材、软件、字体等）仅供学习与参考，请勿用于商业用途。
3.本站所有素材来源于用户上传和网络，如有侵权请请联系客服处理！
4.本站资源售价只是赞助，收取费用仅维持本站的日常运营所需。
博创云素材 » docker下升级并迁移gitlab到最新版本或指定版本

常见问题FAQ

免费下载或者VIP会员专享资源能否直接商用？
本站所有资源版权均属于原作者所有，这里所提供资源均只能用于参考学习用，请勿直接商用。若由于商用引起版权纠纷，一切责任均由使用者承担。更多说明请参考 VIP介绍。
提示下载完但解压或打开不了？
最常见的情况是下载不完整: 可对比下载完压缩包的与网盘上的容量，若小于网盘提示的容量则是这个原因。这是浏览器下载的bug，建议用百度网盘软件或迅雷下载。 若排除这种情况，可在对应资源底部留言，或 联络我们。
小优

小优 普通

分享到：

发表评论

  • 1247稳定运行(天)
  • 597用户总数
  • 6391素材总数(个)
  • 147本周发布(个)
  • 1000资源大小(GB)
立即查看

UU素材网 UUSCW.COM

国内极具人气的网络源码资源交流学习平台
下载源码文章，学软件教程，找灵感素材，尽在UU素材网
按Ctrl+D收藏本站

UU素材网网络共享中心

www. uuscw.com