官方备份文档 : 备份和恢复极狐GitLab
一. 要求
为了能够进行备份和恢复，请确保您系统已安装 Rsync。 如果您安装了极狐GitLab：
- 如果您使用 Omnibus 软件包，则无需额外操作。
- 如果您使用源代码安装，您需要确定是否安装了
rsync。例如：
# Debian/Ubuntu
sudo apt-get install rsync
# RHEL/CentOS
sudo yum install rsync
二. 备份时间戳
备份归档保存在 backup_path 中，该路径在 config/gitlab.yml 文件中指定。文件名是 [TIMESTAMP]_gitlab_backup.tar， 其中 TIMESTAMP 标识每个备份的创建时间和极狐GitLab 的版本。恢复极狐GitLab 需要时间戳，也可以使用多个备份。
例如，如果备份名称是 1493107454_2018_04_25_10.6.4-ce_gitlab_backup.tar，时间戳为 1493107454_2018_04_25_10.6.4-ce。
三. 备份极狐GitLab
极狐GitLab 提供了一个命令行界面来备份您的整个实例包含：
- 数据库
- 附件
- Git 仓库数据
- CI/CD 作业输出日志
- CI/CD 作业产物
- LFS 对象
- Terraform 状态（引入于极狐GitLab 14.7）
- 容器镜像库镜像
- 极狐GitLab 页面内容
- 包（引入于极狐GitLab 14.7）
- 代码片段
- 群组 Wiki
备份不包括
- Mattermost 数据
- Redis（和 Sidekiq 作业）
命令
- 极狐GitLab 12.2 及更高版本：
sudo gitlab-backup create
- 极狐GitLab 12.1 及更早版本：
gitlab-rake gitlab:backup:create
如果您使用源代码安装极狐GitLab，请使用以下命令：
sudo -u git -H bundle exec rake gitlab:backup:create RAILS_ENV=production
如果您在 Docker 容器中运行极狐GitLab，请基于您安装的极狐GitLab 版本从主机运行备份：
- 极狐GitLab 12.2 及更高版本：
docker exec -t <container name> gitlab-backup create
- 极狐GitLab 12.1 及更早版本：
docker exec -t <container name> gitlab-rake gitlab:backup:create
示例输出：
检查备份文件
ls -l /var/opt/gitlab/backups/
四. 完整命令
## 备份
sudo gitlab-backup create
## 检查文件
ls -l /var/opt/gitlab/backups/
# 创建目标目录
mkdir -p /home/mada/gitlab-backups
# 复制所有备份文件
sudo cp /var/opt/gitlab/backups/*.tar /home/mada/gitlab-backups/
# 或者只复制特定的备份文件
sudo cp /var/opt/gitlab/backups/1737767819_2025_01_25_17.7.0-jh_gitlab_backup.tar /home/mada/gitlab-backups/
# 复制 gitlab.rb 和 gitlab-secrets.json 文件
sudo cp /etc/gitlab/gitlab.rb /home/mada/gitlab-backups/
sudo cp /etc/gitlab/gitlab-secrets.json /home/mada/gitlab-backups/
# 验证文件是否已成功复制
ls -l /home/mada/gitlab-backups/
# 调整文件权限（可选）
sudo chown -R mada:mada /home/mada/gitlab-backups/
sudo chmod -R 600 /home/mada/gitlab-backups/*