Welcome to mirror list, hosted at ThFree Co, Russian Federation.

gitlab.com/gitlab-org/gitaly.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSami Hiltunen <shiltunen@gitlab.com>2020-11-10 17:51:26 +0300
committerSami Hiltunen <shiltunen@gitlab.com>2020-11-10 18:01:28 +0300
commite8754f72fc13a9ab749c9f2727270572f4c30b8c (patch)
treea665853c624b05ebc043dd72759c16c19a5aac11
parenta6aa071496ff28980fea860cac2dd7574183f0f7 (diff)
add demo steps for repository importer
Adds demo steps for performing a repository import to create missing database records.
-rw-r--r--.gitlab/issue_templates/Demo.md22
1 files changed, 22 insertions, 0 deletions
diff --git a/.gitlab/issue_templates/Demo.md b/.gitlab/issue_templates/Demo.md
index ac27ccc9c..d9a6c2324 100644
--- a/.gitlab/issue_templates/Demo.md
+++ b/.gitlab/issue_templates/Demo.md
@@ -99,6 +99,28 @@ succeed.
- [ ] Check there's no dataloss anymore with `sudo /opt/gitlab/embedded/bin/praefect -config /var/opt/gitlab/praefect/config.toml dataloss`
- [ ] Check the `Read only repositories` [dashboard exists](https://gitlab.com/gitlab-org/gitaly/-/issues/3126) and is 0
+### Repository Importer #3033
+
+Repository importer's goal is to create any missing database records for repositories present on the disk of the primary Gitaly.
+
+1. Prep:
+ - [ ] Create a repository in the demo cluster. This ensures we have a repository on the disk we can import.
+ - [ ] Stop the Praefect nodes. The import job runs when Praefect starts.
+ - [ ] Truncate `virtual_storages` table. This removes the information whether the migration has been completed.
+ - [ ] Truncate `repositories` table. This removes any information about the repositories on the virtual storage.
+ - [ ] Truncate `storage_repositories` table. This removes any information about repositories hosted on the Gitaly nodes.
+1. [ ] Demo:
+ - [ ] Start the Praefect nodes.
+ - [ ] Tail Praefects' logs.
+1. [ ] Verify:
+ - [ ] Logs do not contain `importing repositories to database failed` indicating any import failures.
+ - [ ] Logs contain `imported repositories to database` message. It should list the repository created earlier as imported.
+ - [ ] Logs contain `repository importer finished` message. It should list the configured virtual storages as successfully imported.
+ - [ ] Verify `repositories` table contains records for the imported repositories with generation `0`.
+ - [ ] Verify `storage_repositories` records the primary containing the imported repositories on generation `0`. Secondaries might have records as well if the automatic reconciler scheduled jobs to replicate the
+ repositories to them.
+ - [ ] Verify `virtual_storages` table contains records with `repositories_imported` set for the successfully imported virtual storages.
+
## After Demo
1. [ ] Create any follow up issues discovered during the demo and assign label