Geo: Improve no downtime upgrade documentation
Right now we have documentation on how to do a no-downtime upgrade for Omnibus in https://docs.gitlab.com/omnibus/update/README.html#updating-with-no-downtime-in-9-1-or-higher (https://docs.gitlab.com/omnibus/update/README.html#zero-downtime-updates ?).
However, we now have customers who are using both Geo primaries and secondaries in an HA setup who also want no-downtime migrations.
I think at the minimum we need to add these notes:
- Extend the documentation to mention that the primary and secondaries should be thought of as "one big cluster" where each node should be updated with the latest code.
- Designate a Deploy Node on both primary and secondary Geo clusters.
- Ensure the primary has
gitlab_rails['auto_migrate'] = falseandgeo_secondary['auto_migrate'] = false - Run
SKIP_POST_DEPLOYMENT_MIGRATIONS=true gitlab-rake db:migrateon the Geo primary - Run
SKIP_POST_DEPLOYMENT_MIGRATIONS=true gitlab-rake geo:db:migrateon the Geo secondary - HUP
unicornandsidekiqon primary and secondary - Run
gitlab-rake db:migrateon the Geo primary - Run
gitlab-rake geo:db:migrateon the Geo secondary - Restart
geo-logcursorandsidekiqon the Geo secondary - Run
gitlab-rake gitlab:geo:checkon both the primary and secondary
Edited by Ash McKenzie