Note: This is not officially supported yet, please don't use as your only Disaster Recovery strategy as you may lose data.
GitLab Geo replicates your database and your Git repositories. We will support and replicate more data in the future, that will enable you to fail-over with minimal effort, in a disaster situation.
See current limitations for more information.
We don't provide yet an automated way to promote a node and do fail-over, but you can do it manually if you have
root access to the machine.
You must make the changes in the exact specific order:
Open the interactive rails console:
sudo gitlab-rails console and execute:
List your primary node and note down it's id:
Turn your primary into a secondary:
List your secondary nodes and note down the id of the one you want to promote:
To promote a node with id
Now you have to cleanup your new promoted node by running:
And refresh your old primary node to behave correctly as secondary (assuming id is
To exit the interactive console, type:
Rsync everything in
/var/opt/gitlab/gitlab-rails/shared from your old node to the new one.