Docker 中的GitLab备份、升级和迁移

Docker 中安装的 GitLab 怎么进行备份？

1. 备份和升级

1.1. 备份当前GitLab实例

输入备份指令对数据进行备份

如果有必要请将备份生成的文件 1723711757_2024_08_15_16.4.1_gitlab_backup.tar 复制到安全地址

docker exec -t <container name> gitlab-backup create

手动备份配置文件

/etc/gitlab/gitlab-secrets.json
/etc/gitlab/gitlab.rb

1.1.1. 停止并移除当前的GitLab容器

停止当前运行的GitLab容器：

docker stop gitlab

移除容器（移除容器不会删除数据卷）：

docker rm gitlab

要在Docker中更新GitLab，你可以按照以下步骤操作：

1.1.2. 备份当前GitLab实例

在进行更新之前，建议先备份GitLab的数据和配置，以防出现问题时可以恢复到原来的状态。

bash
Copy code
docker exec -t gitlab gitlab-backup create

将生成的备份文件保存到安全的位置：

bash
Copy code
docker cp gitlab:/var/opt/gitlab/backups ./gitlab_backups/

1.1.3. 停止并移除当前的GitLab容器

停止当前运行的GitLab容器：

bash
Copy code
docker stop gitlab

移除容器（移除容器不会删除数据卷）：

bash
Copy code
docker rm gitlab

1.2. 安装新版本的 GitLab

1.2.1. 拉取新的GitLab镜像

根据你想要更新到的版本，拉取新的GitLab镜像。例如，要更新到17.2.2：

docker pull gitlab/gitlab-ce

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

⚠️ 国内的 docker 被禁止访问了，现在从 docker 拉取镜像必须要使用 Proxy

1.2.2. 部署 Gitlab 镜像

命令行部署可查看运行日志，所以更推荐使用命令行部署

It seems you are upgrading from 16.4.1 to 17.3.0.
It is required to upgrade to the latest 16.11.x version first before proceeding.
Please follow the upgrade documentation at https://docs.gitlab.com/ee/update/index.html #upgrading-to-a-new-major-version

⚠️ 升级的版本跨度太大，需要逐级升级

It seems you are upgrading from 16.4.1 to 16.11.7.
It is required to upgrade to the latest 16.7.x version first before proceeding.
Please follow the upgrade documentation at https://docs.gitlab.com/ee/update/#upgrade-paths

• 升级到gitlab-ce:16.7.6-ce.0

# remove
docker rm gitlab

# pull
docker pull gitlab/gitlab-ce:16.7.6-ce.0

# run
docker run \
  --publish 9443:443 \
  --publish 9080:80 \
  --publish 9022:22 \
  --name gitlab \
  --privileged=true \
  --volume /volume3/docker/gitlab/config:/etc/gitlab \
  --volume /volume3/docker/gitlab/logs:/var/log/gitlab \
  --volume /volume3/docker/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:16.7.6-ce.0

💡 Gitlab 升级需要花费大量时间迁移和验证数据，需要等待约 20 分钟

• 升级到gitlab/gitlab-ce:16.11.7-ce.0

# remove
docker rm gitlab

# pull
docker pull gitlab/gitlab-ce:16.7.6-ce.0

# run
docker run \
  --publish 9443:443 \
  --publish 9080:80 \
  --publish 9022:22 \
  --name gitlab \
  --privileged=true \
  --volume /volume3/docker/gitlab/config:/etc/gitlab \
  --volume /volume3/docker/gitlab/logs:/var/log/gitlab \
  --volume /volume3/docker/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:16.11.7-ce.0

💡 确保 Gitlab 正常运行后，可在命令行运行时添加 --detach 指令让镜像运行于后台

• 升级到gitlab/gitlab-ce:17.2.2-ce.0

# remove
docker rm gitlab

# pull
docker pull gitlab/gitlab-ce:17.2.2-ce.0

# run
docker run \
  --publish 9443:443 \
  --publish 9080:80 \
  --publish 9022:22 \
  --user 1026:100 \
  --name gitlab \
  --privileged=true \
  --volume /volume3/docker/gitlab/config:/etc/gitlab \
  --volume /volume3/docker/gitlab/logs:/var/log/gitlab \
  --volume /volume3/docker/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce:17.2.2-ce.0

1.2.3. 更新完成

截止 2024-08-22 11:45:27 已成功更新到 Gitlab latest 版本

docker run \
  --publish 9443:443 \
  --publish 9080:80 \
  --publish 9022:22 \
  --name gitlab \
  --privileged=true \
  --volume /volume3/docker/gitlab/config:/etc/gitlab \
  --volume /volume3/docker/gitlab/logs:/var/log/gitlab \
  --volume /volume3/docker/gitlab/data:/var/opt/gitlab \
  gitlab/gitlab-ce

    --user 1026:100 \

2. Docker Gitlab 迁移

2.1. 停止 Gitlab 并迁移数据

# stop gitlab
docker stop gitlab

# cp data files from the old server
scp -r root@192.168.0.53:/volume3/docker/gitlab/config ./
scp -r root@192.168.0.53:/volume3/docker/gitlab/data ./
scp -r root@192.168.0.53:/volume3/docker/gitlab/logs ./

2.2. 启动容器

2.2.1. 准备 docker-compose.yml

准备和原容器一模一样的 docker-compose.yml

version: '3.8'

services:
  gitlab:
    image: gitlab/gitlab-ce:17.3.0-ce.0
    container_name: gitlab
    privileged: true
    restart: always
    healthcheck:
      disable: true
    ports:
      - "9443:443"
      - "9080:80"
      - "9022:22"
    volumes:
      - /volume1/docker/gitlab_docker_transfer/config:/etc/gitlab
      - /volume1/docker/gitlab_docker_transfer/logs:/var/log/gitlab
      - /volume1/docker/gitlab_docker_transfer/data:/var/opt/gitlab

2.2.2. 启动服务

docker-compose up -d

• ⚠️如果启动失败，大概率是文件夹权限不够
• 💡解决方法：修改 data文件夹权限为全 0777 全读写

• 0777 代表：

• • 所有者：读取、写入、执行（7）
  • 组用户：读取、写入、执行（7）
  • 其他用户：读取、写入、执行（7）

sudo chmod -R 0777 data

• ✅修改完成后，可正常启动