本文记录Gitlab跨版本升级的具体操作过程。
按照官方的说法，gitlab允许小版本直接升级，大版本需要阶段升级。
跨版本升级示例：11.0.x -> 11.11.x -> 12.0.x -> 12.10.x -> 13.0.x。
官方推荐的升级路线文档：https://docs.gitlab.com/ee/policy/maintenance.html#upgrade-recommendations
目的
实现gitlab版本：11.2.3到13.0.0版本的升级，我选择的升级路线是：11.2.3 => 11.11.8 => 12.0.12 => 12.10.6
我当前创建gitlab容器的脚本如下：
sudo docker run --detach \
--hostname gitlab.example.com \
--publish 8443:443 --publish 8080:80 --publish 8022:22 \
--name gitlab \
--restart always \
--volume /home/ubuntu/Apps/gitlab/etc/gitlab:/etc/gitlab \
--volume /home/ubuntu/Apps/gitlab/var/log/gitlab/logs:/var/log/gitlab \
--volume /home/ubuntu/Apps/gitlab/var/opt/gitlab:/var/opt/gitlab \
gitlab/gitlab-ce:11.2.3-ce.0
我当前的gitlab容器已经将/etc/gitlab，/var/log/gitlab，/var/opt/gitlab挂载到了宿主机上。
操作步骤
进入gitlab容器，停止gitlab服务，然后退出容器：
sudo docker exec -it gitlab /bin/bash
# 进入容器后执行
gitlab-ctl stop
退出容器后，删除gitlab容器：
sudo docker rm gitlab -f
使用新版本的脚本运行gitlab容器，这里只修改gitlab的镜像版本就可以了：
sudo docker run --detach \
--hostname gitlab.example.com \
--publish 8443:443 --publish 8080:80 --publish 8022:22 \
--name gitlab \
--restart always \
--volume /home/ubuntu/Apps/gitlab/etc/gitlab:/etc/gitlab \
--volume /home/ubuntu/Apps/gitlab/var/log/gitlab/logs:/var/log/gitlab \
--volume /home/ubuntu/Apps/gitlab/var/opt/gitlab:/var/opt/gitlab \
gitlab/gitlab-ce:11.2.3-ce.0
启动容器后，查看容器运行状态：
sudo docker ps | grep gitlab
等到容器状态为Up xxx (healthy)后，进入容器，停掉gitlab服务。。。
后面就是重复工作了，直到运行最新版本的gitlab容器。
Gitlab备份
在升级之前，最好先对gitlab数据做一个全量备份，避免升级失败造成的不可逆影响。
具体的还原操作如下：
如果你和我一样使用gitlab容器，首先进入容器，然后执行备份命令：
gitlab-ctl gitlab:backup:create
以上命令执行完后，会在容器的/var/opt/gitlab/backups目录下创建文件名类似1592276197_2020_06_16_11.2.3_gitlab_backup.tar的备份文件。
Gitlab还原
如果你想利用gitlab的备份文件还原，那么你运行还原操作的gitlab必须和备份时使用的gitlab版本一致，否则可能会出现还原失败的问题。
具体的还原操作如下：
如果你和我一样使用gitlab容器，首先将gitlab的备份文件拷贝到/var/opt/gitlab/backups/目录下，然后进入gitlab容器，执行还原命令：
gitlab-ctl gitlab:backup:restore BACKUP=1592276197_2020_06_16_11.2.3
BACKUP命令参数指定值为/var/opt/gitlab/backups/目录下的备份文件，但是无需携带_gitlab_backup.tar后缀。
网友评论