Document migration from single database to decomposed for chart-based installations
Problem to solve
We need to document how administrators can migrate from single database to decomposed
We do have documentation for configuring second database. But we do not have documentation for the data migration.
High level overview:
- Stop GitLab and Background Migrations
- Create new
gitlabhq_production_cidatabase - Copy data from
gitlabhq_productiontogitlabhq_production_cidatabase. - Change database configuration
- Lock writes, Start GitLab and truncate data
Intended audience is administrators responsible for running a GitLab instance (self-managed)
Open Question
- Is this procedure the same as for Operator install?
Other links/references
- Documentation for self-compiled installation and Linux Package: https://docs.gitlab.com/ee/administration/postgresql/multiple_databases.html
Definition of done
- Document the steps
- Install a single-db GitLab instance using Helm Chart
- Following the steps should result in a GitLab instance running on two databases (
mainandci)
Edited by Rutger Wessels