如何在Linux上使用GitLab進行代碼備份與恢復

一、備份前的準備工作

1. 確認GitLab版本：恢復時目標服務器的GitLab版本需與備份版本一致或兼容（推薦相同版本），可通過以下命令查看版本：

   sudo gitlab-rake gitlab:env:info | grep "GitLab version"
   

   或

   cat /opt/gitlab/version-manifest.txt | grep "gitlab-ce"
   

二、Linux下GitLab備份步驟

1. 手動備份（全量）

使用GitLab內置的Rake任務創建全量備份，包含倉庫、數據庫、用戶/組、密鑰、權限等信息：

sudo gitlab-rake gitlab:backup:create

• 默認存儲路徑：備份文件生成于/var/opt/gitlab/backups/目錄，文件名格式為TIMESTAMP_gitlab_backup.tar（如1710000000_2025_09_25_16.11.10_gitlab_backup.tar）。
• 修改備份路徑：若需更改存儲位置，編輯/etc/gitlab/gitlab.rb文件，設置：

  gitlab_rails['manage_backup_path'] = true
  gitlab_rails['backup_path'] = "/path/to/custom/backups"  # 自定義路徑（如/mnt/gitlab_backups）
  

  保存后運行sudo gitlab-ctl reconfigure使配置生效。

2. 自動化定時備份

通過Cron Job設置定時任務，實現每日自動備份（例如每天凌晨2點）：

# 編輯當前用戶的crontab
crontab -e

添加以下內容（需替換為實際備份路徑）：

0 2 * * * /opt/gitlab/bin/gitlab-rake gitlab:backup:create

保存退出后，Cron會自動執行每日備份。

3. 備份文件管理

• 限制保留時間：編輯/etc/gitlab/gitlab.rb，設置備份保留天數（如7天）：

  gitlab_rails['backup_keep_time'] = 604800  # 單位：秒（604800秒=7天）
  

  運行sudo gitlab-ctl reconfigure后，GitLab會自動刪除過期備份。
• 手動清理舊備份：若需立即清理，可使用以下命令刪除7天前的備份文件：

  find /var/opt/gitlab/backups -type f -mtime +7 -exec rm -rf {} \;
  

三、Linux下GitLab恢復步驟

1. 準備恢復環境

• 停用GitLab服務：確保數據一致性，停止與GitLab相關的關鍵服務：

  sudo gitlab-ctl stop puma  # 停止Web服務
  sudo gitlab-ctl stop sidekiq  # 停止后臺任務
  

  或一鍵停止所有服務：

  sudo gitlab-ctl stop
  

2. 執行恢復操作

將備份文件復制到目標服務器的backup_path目錄（如/var/opt/gitlab/backups/），然后運行恢復命令：

sudo gitlab-rake gitlab:backup:restore BACKUP=TIMESTAMP  # 替換為備份文件的時間戳（如1710000000）

• 確認恢復：命令會提示“Do you want to continue (yes/no)?”，輸入yes并按回車鍵繼續。

3. 恢復配置與啟動服務

• 恢復配置文件：若備份了/etc/gitlab目錄（參考備份步驟中的“打包配置文件”），需將其解壓并重新配置：

  sudo tar -xf gitlab_conf.tar -C /  # 解壓到根目錄
  sudo gitlab-ctl reconfigure  # 重新加載配置
  

• 啟動GitLab服務：

  sudo gitlab-ctl start  # 啟動所有服務
  

4. 驗證恢復結果

• 檢查服務狀態：運行以下命令確認GitLab服務運行正常：

  sudo gitlab-ctl status
  

• 驗證數據完整性：登錄GitLab Web界面，檢查項目、用戶、組等數據是否恢復完整；或使用Git命令克隆倉庫，確認代碼歷史是否存在：

  git clone http://your-gitlab-server.com/username/repository.git
  

四、注意事項

• 版本一致性：恢復前務必確認目標服務器GitLab版本與備份版本一致，否則可能導致恢復失敗。
• 備份文件權限：備份文件需存儲在安全位置（如加密磁盤、遠程服務器），避免敏感信息泄露。
• 定期測試恢復：建議每季度測試一次備份文件的恢復流程，確保備份有效性。