Upgrade procedure in Omnibus HA active/active environment not documented
Upgrading in an HA environment with multiple active nodes is not documented here: https://docs.gitlab.com/omnibus/update/README.html
I looked and found no documentation specifically for this anywhere else and believe it belongs in the above-linked document. Additionally, the steps for initial configuration of this type of installation are documented here: https://docs.gitlab.com/ce/administration/high_availability/README.html For completeness in HA operation, this page needs a link to whatever upgrade documentation we do provide on this.
Proper upgrade procedure for HA environments is as follows:
- On the installs that are not going to be the first to be updated set
gitlab_rails['auto_migrate'] = false
AND/OR touch the/etc/gitlab/skip-auto-migrations
file. - Upgrade the first installation.
- Upgrade the other installations after the first is finished.
- For subsequent upgrades simply upgrade in the same order.
- To change which node is upgraded first in the future, remove/add
/etc/gitlab/skip-auto-migrations
orgitlab_rails['auto_migrate'] = false
setting(s) as needed so the first installation to be processed does NOT have this set.
Edited by 🤖 GitLab Bot 🤖