升级 Docker 实例

将基于 Docker 的实例升级到更高版本的极狐GitLab。

先决条件#

在升级 Docker 实例之前，您必须先阅读所需信息并执行所需步骤。

升级基于 Docker 的实例#

要升级基于 Docker 的实例：

1. 考虑在升级期间开启维护模式。
2. 暂停运行中的 CI/CD 流水线和作业。
3. 将极狐GitLab Runner 升级到与目标极狐GitLab 版本相同的版本。
4. 通过以下任一方式升级极狐GitLab 本身：
   • 使用 Docker Engine。
   • 使用 Docker Compose。

升级后：

1. 取消暂停运行中的 CI/CD 流水线和作业。
2. 如果已启用，关闭维护模式。
3. 运行升级健康检查。

使用 Docker Engine 升级#

要升级使用 Docker Engine 安装的极狐GitLab 实例：

1. 创建备份。至少备份 数据库和极狐GitLab 密钥文件。

2. 停止正在运行的容器：

   shell
   sudo docker stop gitlab

3. 移除现有容器：

   shell
   sudo docker rm gitlab

4. 拉取新镜像：

shell
   sudo docker pull registry.gitlab.cn/omnibus/gitlab-jh:<version>-jh.0

shell
   sudo docker pull registry.gitlab.cn/omnibus/gitlab-jh:<version>-jh.0

1. 确保已定义 GITLAB_HOME 环境变量：

   shell
   echo $GITLAB_HOME

2. 使用之前指定的选项再次创建容器：

   shell
   1sudo docker run --detach \
   2--hostname gitlab.example.com \
   3--publish 443:443 --publish 80:80 --publish 22:22 \
   4--name gitlab \
   5--restart always \
   6--volume $GITLAB_HOME/config:/etc/gitlab \
   7--volume $GITLAB_HOME/logs:/var/log/gitlab \
   8--volume $GITLAB_HOME/data:/var/opt/gitlab \
   9--shm-size 256m \
   10registry.gitlab.cn/omnibus/gitlab-jh:<version>-jh.0

首次运行时，极狐GitLab 会重新配置并自行升级。

使用 Docker Compose 升级#

要升级使用 Docker Compose 安装的极狐GitLab 实例：

1. 创建备份。至少备份 数据库和极狐GitLab 密钥文件。

2. 编辑 docker-compose.yml 并更改要拉取的版本。

3. 下载最新版本并升级您的极狐GitLab 实例：

   shell
   docker compose pull
   docker compose up -d