ubuntu gitlab遷移與兼容性處理

一、遷移前準備

1. 版本一致性檢查
   確保新舊服務器GitLab版本一致（可通過cat /opt/gitlab/embedded/service/gitlab-rails/VERSION查看版本號），避免因版本差異導致數據結構不兼容。

   • 若版本不一致，需先在新服務器安裝與舊服務器相同的GitLab版本（參考使用舊版本包或通過Docker部署避免兼容性問題）。

2. 備份數據

   • 備份配置文件：/etc/gitlab/gitlab.rb、/etc/gitlab/gitlab-secrets.json。
   • 備份數據：執行sudo gitlab-rake gitlab:backup:create，備份文件存放在/var/opt/gitlab/backups/。

二、遷移操作步驟

1. 安裝GitLab
   在新服務器安裝與舊版本相同的GitLab：

   wget https://packages.gitlab.com/install/repositories/gitlab/gitlab-ce/script.deb.sh  
   sudo bash script.deb.sh  
   sudo apt-get install gitlab-ce=[舊版本號]-ce.0_amd64.deb  
   

2. 恢復數據

   • 將備份文件復制到新服務器/var/opt/gitlab/backups/，并賦予權限：
     sudo chmod 777 *.tar。
   • 停止服務：sudo gitlab-ctl stop unicorn sidekiq。
   • 恢復數據：sudo gitlab-rake gitlab:backup:restore BACKUP=[備份文件名]，按提示輸入yes。

3. 配置與重啟

   • 替換配置文件：將備份的gitlab.rb和gitlab-secrets.json復制到/etc/gitlab/。
   • 重新配置并啟動服務：
     sudo gitlab-ctl reconfigure && sudo gitlab-ctl restart。

三、兼容性處理要點

1. 數據庫兼容性

   • 若新舊服務器PostgreSQL版本差異較大，需手動遷移數據庫（參考使用pg_dump/psql導出導入）。
   • 確保gitlab.rb中數據庫連接參數（如host、port）正確。

2. 存儲路徑與附件

   • 若原服務器自定義了倉庫存儲路徑（git_data_dir），需在新服務器gitlab.rb中同步配置，并復制倉庫文件。
   • 遷移附件目錄/var/opt/gitlab/shared/，確保文件權限正確。

3. 特殊組件處理

   • CI/CD Runner：需在新服務器重新注冊Runner，或修改config.toml中的GitLab URL。
   • 對象存儲：若使用外部存儲（如S3），需在新服務器gitlab.rb中配置相同的訪問密鑰和參數。

四、驗證與注意事項

1. 功能驗證

   • 訪問新服務器Web界面，檢查項目、用戶、權限是否正常。
   • 執行代碼拉取/推送測試，確保倉庫訪問正常。

2. 風險控制

   • 遷移前確認新服務器磁盤空間充足，避免因空間不足導致失敗。
   • 操作前備份所有數據，建議在低峰期執行，避免影響用戶使用。

參考來源：