diff options
author | Sami Hiltunen <shiltunen@gitlab.com> | 2020-11-10 17:51:26 +0300 |
---|---|---|
committer | Sami Hiltunen <shiltunen@gitlab.com> | 2020-11-10 18:01:28 +0300 |
commit | e8754f72fc13a9ab749c9f2727270572f4c30b8c (patch) | |
tree | a665853c624b05ebc043dd72759c16c19a5aac11 | |
parent | a6aa071496ff28980fea860cac2dd7574183f0f7 (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.md | 22 |
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 |