Linux系統中GitLab的備份與恢復方法

Linux系統中GitLab備份與恢復方法

一、備份方法

1. 手動備份（全量/部分）

GitLab提供內置rake任務實現全量或部分數據備份。全量備份包含倉庫、數據庫、用戶/組、密鑰等所有數據，命令如下：

sudo gitlab-rake gitlab:backup:create

備份文件默認存儲在/var/opt/gitlab/backups目錄，文件名格式為<timestamp>_gitlab_backup.tar（如1711234567_gitlab_backup.tar）。
若需排除特定部分（如artifacts、builds），可使用--skip參數：

sudo gitlab-rake gitlab:backup:create SKIP=artifacts,builds

2. 定時自動備份

通過crontab設置定時任務，實現每日自動備份。例如，每天凌晨2點執行全量備份：

sudo crontab -e

添加以下內容：

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

若需自定義備份路徑，可修改/etc/gitlab/gitlab.rb配置文件：

gitlab_rails['backup_path'] = '/path/to/custom/backup'

修改后執行sudo gitlab-ctl reconfigure使配置生效。

3. 備份敏感配置文件

備份gitlab.rb（GitLab主配置）和gitlab-secrets.json（加密密鑰，如數據庫密碼、OAuth令牌）至關重要，避免恢復后無法登錄或數據泄露：

sudo cp /etc/gitlab/gitlab.rb /path/to/backup/
sudo cp /etc/gitlab/gitlab-secrets.json /path/to/backup/

二、恢復方法

1. 恢復前準備

• 停止關鍵服務：確保數據一致性，停止unicorn（Web服務）和sidekiq（后臺任務）：

  sudo gitlab-ctl stop unicorn
  sudo gitlab-ctl stop sidekiq
  

  或一鍵停止所有服務：

  sudo gitlab-ctl stop
  

2. 執行恢復操作

將備份文件復制到/var/opt/gitlab/backups目錄（若路徑有修改，需對應調整），然后運行恢復命令：

sudo gitlab-rake gitlab:backup:restore BACKUP=<timestamp>

其中<timestamp>為備份文件名中的時間戳（如1711234567）?；謴瓦^程中會提示確認覆蓋現有數據，輸入yes繼續。

3. 恢復后啟動服務

恢復完成后，啟動GitLab所有服務：

sudo gitlab-ctl start

或逐一啟動關鍵服務：

sudo gitlab-ctl start unicorn
sudo gitlab-ctl start sidekiq

三、注意事項

• 版本匹配：恢復的GitLab版本必須與備份時的版本一致或更高（如備份時為16.7.6，恢復時可使用16.7.6及以上版本），否則可能出現兼容性問題。
• 備份驗證：定期測試備份文件的完整性，可通過恢復到測試環境確認數據是否可用，避免災難發生時無法恢復。
• 安全存儲：備份文件包含敏感信息（如代碼、用戶數據），需存儲在安全位置（如加密磁盤、異地備份服務器），并限制訪問權限。