如何备份GitLab组？执行sudo gitlab-backup create生成过小备份文件的疑问

问题根源 #

sudo gitlab-backup create 默认备份整个GitLab实例，你得到300KB小文件的原因大概率是实例中仅包含少量元数据，或者误触发了部分备份流程。要针对单个组备份，需明确指定备份范围，而非通过URL指定。

单个组备份步骤 #

1. 获取组标识 #

登录GitLab后进入目标组主页，通过以下方式获取组的唯一标识：

• 组ID：进入组「设置」→「通用」页面，在「组ID」字段查看；
• 组路径：直接使用组的URL路径（比如组URL是https://gitlab.example.com/my-team，路径就是my-team）。

2. 执行指定组的备份命令 #

使用BACKUP_INCLUDE环境变量限定备份范围，命令格式如下：

sudo gitlab-backup create BACKUP_INCLUDE="groups:<组ID或路径>"

示例：

# 用组ID备份
sudo gitlab-backup create BACKUP_INCLUDE="groups:123"
# 用组路径备份
sudo gitlab-backup create BACKUP_INCLUDE="groups:my-team"

若需备份多个组，用逗号分隔：

sudo gitlab-backup create BACKUP_INCLUDE="groups:my-team,groups:another-group"

3. 确认备份结果 #

备份完成后，生成的.tar文件默认存储在/var/opt/gitlab/backups/目录，文件名格式为_gitlab_backup_<时间戳>.tar。该文件会包含目标组下的所有仓库、Issues、合并请求、Wiki、附件等数据，文件大小会匹配组的实际数据量。

注意事项 #

• 该功能要求GitLab版本≥12.10；
• 备份过程中组内会短暂锁定写入操作，建议在业务低峰期执行；
• 若全实例备份仍异常，可检查/etc/gitlab/gitlab.rb中git_data_dirs配置，确认仓库存储路径是否正确。

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