GitLab 版本升級

升級前需要參考官方指引，逐版本升級

官方指引

https://docs.gitlab.com/ee/update/index.html#upgrade-paths
8.11.Z -> 8.12.0 -> 8.17.7 -> 9.5.10 -> 10.8.7 -> 11.11.8 -> -> 12.1.17 -> 12.10.14 -> -> 13.1.11 -> 13.8.8 -> 13.12.15 -> 14.0.12 -> 14.3.6 -> 14.9.5 -> 14.10.Z -> 15.0.Z -> 15.4.0 -> latest 15.Y.Z12.0.1213.0.14

官方發(fā)布版本

https://about.gitlab.com/releases/categories/releases

查看備份目錄

shell cat /etc/gitlab/gitlab.rb |grep backup_path

執(zhí)行備份

shell gitlab-rake gitlab:backup:create

手工備份兩個敏感文件
/etc/gitlab/gitlab-secrets.json
/etc/gitlab/gitlab.rb

查看當(dāng)前版本

shell cat /opt/gitlab/embedded/service/gitlab-rails/VERSION

安裝指定版本

shell yum install gitlab-ce-15.3.2

跨大版本升級時，可能會出現(xiàn)數(shù)據(jù)結(jié)構(gòu)變更，執(zhí)行以下命令行

shell sudo chmod 0755 /var/opt/gitlab/postgresql
shell sudo gitlab-rake db:migrate
shell sudo gitlab-ctl restart postgresql

升級完成后，執(zhí)行以下命令行

shell sudo gitlab-ctl reconfigure
shell sudo gitlab-ctl restart

訪問頁面顯示 502 時，可嘗試以下命令行解決

shell sudo systemctl restart gitlab-runsvdir
shell sudo gitlab-ctl restart sidekiq
shell sudo gitlab-ctl hup unicorn

備份還原

需要注意的是，還原的前提條件是 GitLab 版本要跟備份時的版本完全一致

執(zhí)行以下命令行，BACKUP 為備份文件去掉 _gitlab_backup.tar 后的名稱，如文件名為 1662359186_2022_09_05_14.6.3_gitlab_backup.tar，取前面的 1662359186_2022_09_05_14.6.3

gitlab-rake gitlab:backup:restore BACKUP=1662359186_2022_09_05_14.6.3

如果還原過程中出現(xiàn)權(quán)限錯誤，請于備份目錄下執(zhí)行下面命令

Unpacking backup ... tar: 1662359186_2022_09_05_14.6.3_gitlab_backup.tar: Cannot open: Permission denied
tar: Error is not recoverable: exiting now
unpacking backup failed

chmod 644 *

最后記得別忘了還原兩個敏感文件

完成后重啟 GitLab 即可