本文记录 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 => 13.0.0 => 13.1.2
我当前创建 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-rake gitlab:backup:create
以上命令执行完后，会在容器的 /var/opt/gitlab/backups 目录下创建文件名类似 1592276197_2020_06_16_11.2.3_gitlab_backup.tar 的备份文件。
如果你想利用 gitlab 的备份文件还原，那么你运行还原操作的 gitlab 必须和备份时使用的 gitlab 版本一致，否则可能会出现还原失败的问题。
具体的还原操作如下：
如果你和我一样使用 gitlab 容器，首先将 gitlab 的备份文件拷贝到 /var/opt/gitlab/backups/ 目录下，然后进入 gitlab 容器，执行还原命令：
gitlab-rake gitlab:backup:restore BACKUP=1592276197_2020_06_16_11.2.3
BACKUP命令参数指定值为/var/opt/gitlab/backups/目录下的备份文件，但是无需携带_gitlab_backup.tar后缀。