GitLab releases updates to its Enterprise Edition software very regularly. A major upgrade is always released the 22nd of every month.
Please keep in mind the CSL upgrade guidelines for production systems when deciding whether to upgrade GitLab. When in doubt, ask someone more experienced and BACKUP DATA.
To perform an upgrade,
apt upgrade, GitLab performs a backup of the SQL database.
- Schedule a maintenance period
- Perform a backup of data either via a Ceph snapshot or gitlab-rake
As root on
gitlab, rungitlab-rake gitlab:backup:create STRATEGY=copyto backup all repositories to /var/opt/gitlab/backups
As root on a Ceph monitor, run the following to perform a snapshot of the Ceph image
- Ceph snapshot:
- Run the following to upgrade GitLab
apt update && apt upgrade -y
- The above upgrade will take time to perform. When the upgrade finishes, it should give you a success message. After the upgrade successfully completes, it will take a few minutes for all workers to start up so in that time frame you may see a 502 when accessing the site.
LDAP login may temporarily not work in the minutes after a login. This is fine. If more than 15 minutes have passed and GitLab is not working, perform debugging to fix the problem or rollback the upgrade as per the GitLab docs.