Docker部署的GitLab无法启动，日志无报错或警告

根据日志提示，核心问题是GitLab跨大版本升级必须遵循路径规则：不能直接从14.x跳到15.8.x，必须先升级到15.0.x系列的最新版本，再逐步升级到目标版本。以下是具体解决步骤：

1. 先备份数据（必做，防止数据丢失） #

• 停止当前故障容器：

  docker stop gitlab
  

• 备份GitLab挂载的本地数据目录（假设你的挂载目录是/opt/gitlab，根据实际情况修改）：

  tar -czf gitlab_backup_$(date +%Y%m%d).tar.gz /opt/gitlab
  

如果使用Docker数据卷，可通过临时容器备份：

docker run --rm -v gitlab_data:/data -v $(pwd):/backup busybox tar -czf /backup/gitlab_backup_$(date +%Y%m%d).tar.gz /data

2. 拉取15.0.x系列的最新镜像 #

15.0.x的最后一个稳定版本是15.0.13-ce.0，直接拉取：

docker pull gitlab/gitlab-ce:15.0.13-ce.0

3. 启动15.0.x容器完成过渡升级 #

• 移除当前故障容器：

  docker rm gitlab
  

• 用15.0.x镜像启动容器，使用和之前一致的挂载、端口配置（示例命令，根据你的实际启动参数调整）：

  docker run -d \
    --name gitlab \
    --publish 443:443 --publish 80:80 --publish 22:22 \
    --volume /opt/gitlab/config:/etc/gitlab \
    --volume /opt/gitlab/logs:/var/log/gitlab \
    --volume /opt/gitlab/data:/var/opt/gitlab \
    gitlab/gitlab-ce:15.0.13-ce.0
  

• 查看日志等待升级完成：

  docker logs -f gitlab
  

  直到日志中出现GitLab is up and running或类似服务启动成功的提示，再执行下一步。

4. 升级到目标版本15.8.0-ce.0 #

• 停止15.0.x容器：

  docker stop gitlab
  

• 移除容器：

  docker rm gitlab
  

• 用目标版本镜像启动容器（本地已有镜像则直接使用，否则会自动拉取）：

  docker run -d \
    --name gitlab \
    --publish 443:443 --publish 80:80 --publish 22:22 \
    --volume /opt/gitlab/config:/etc/gitlab \
    --volume /opt/gitlab/logs:/var/log/gitlab \
    --volume /opt/gitlab/data:/var/opt/gitlab \
    gitlab/gitlab-ce:15.8.0-ce.0
  

• 查看日志确认启动成功：

  docker logs -f gitlab
  

额外注意事项 #

• 如果启动后仍有权限问题，调整本地挂载目录的权限：

  chown -R 999:999 /opt/gitlab/config /opt/gitlab/logs /opt/gitlab/data
  

  （GitLab容器内运行的用户UID/GID为999）
• 若使用Docker Compose部署，只需依次修改docker-compose.yml中的image字段为gitlab/gitlab-ce:15.0.13-ce.0和gitlab/gitlab-ce:15.8.0-ce.0，每次修改后执行docker-compose down && docker-compose up -d即可。

内容的提问来源于stack exchange，提问作者Hirsch