Docs: Reorganize "Setting up Geo" for clarity
Problem
The current structure has multiple points of confusion.
Current docs landing page https://docs.gitlab.com/ee/administration/geo/setup/
- A sysadmin should be able to configure Geo on almost any supported GitLab architecture
- It should be as easy as possible
Currently we have 2 runbook-style docs which address point 2 for simple 1k primary + 1k secondary ref architectures.
But we still fall short in a lot of ways on point 1.
Proposal
This proposal was originally quite different (see the description change). See the thread leading to the current proposal.
Primary setup
1K Geo reference architecture
Configure single-node primary
- Using externally-managed rails DB
- Using Linux-packaged rails DB
2K Geo reference architecture
Configure multi-node primary
- Configure externally managed rails DB - no HA
- Configure Linux-packaged rails DB
3K+ Geo reference architecture
Configure multi-node primary
- Configure externally managed rails DB - HA
- Configure Linux-packaged rails DB
Secondary setup
1K Geo reference architecture
Configure single-node secondary
- Using externally-managed rails DB
- Using Linux-packaged rails DB
- Configure externally-managed Geo tracking DB
- Configure Linux packaged Geo tracking DB
2K Geo reference architecture
Configure multi-node secondary
- Rails DB - no HA
- Configure externally-managed rails DB
- Configure Linux-packaged rails DB
- Geo tracking DB - no HA
- Configure externally-managed Geo tracking DB
- Configure Linux-packaged Geo tracking DB
3K+ Geo reference architecture
Configure multi-node secondary
- Rails DB - HA
- Configure externally-managed rails DB
- Configure Linux-packaged rails DB
- Geo tracking DB - HA
- Configure externally-managed Geo tracking DB
- Configure Linux-packaged Geo tracking DB
Edited by Michael Kozono