Document three-step migration process for Helm chart installations to use the container registry metadata database

Context

Currently, it's possible to enable new installations of GitLab deployed using helm to use a database to store container registry metadata.

Problem

In Document one-step approach for migrating existi... (#436406 - closed), we documented the 1-step approach to migrate existing data to the metadata database. However, that approach may not be suitable for large registry instances as documented here.

A three-step approach is possible, however we are currently blocked by Container Registry: allow setting database conf... (gitlab-org/charts/gitlab#5292 - closed).

Solution

Once Container Registry: allow setting database conf... (gitlab-org/charts/gitlab#5292 - closed) is implemented, we can document the three-step approach.

Alternatively, we could also wait for Container Registry: Create import jobs for meta... (gitlab-org/charts/gitlab#5293) and document the automated (or semi-automated?) process.

changed milestone to %16.9

added Category:Container Registry Container Registry Self-Managed Rollout::BlocksOff by Default Package:P1 customer devopspackage documentation groupcontainer registry headway-self-managed-registry-db sectionci typemaintenance workflowin dev labels

marked this issue as related to #436406 (closed)

removed milestone %16.9

added workflowblocked label and removed workflowin dev label

marked this issue as blocked by gitlab-org/charts/gitlab#5292 (closed)

mentioned in issue #436406 (closed)

mentioned in merge request gitlab-org/charts/gitlab!3583 (merged)

changed milestone to %16.11

mentioned in epic &5521

mentioned in merge request gitlab-org/charts/gitlab!3633 (merged)

mentioned in issue #446263 (closed)

added Deliverable label

Setting health status to on track as the milestone has just begun.

Issue participants are welcome to override this by setting the health status to another value.

changed health status to on track

changed milestone to %17.0

This won't be ready for 16.11, moving back to 17.0

mentioned in issue #451600 (closed)

This issue is scheduled for completion in this milestone but doesn't have an assignee. Changing health status to 'needs attention'.

Issue participants are welcome to override this by setting the health status to another value.

changed health status to needs attention

assigned to @jaime

added workflowin dev label and removed workflowblocked label

mentioned in issue gitlab-org/quality/triage-reports#17612 (closed)

This issue is scheduled for completion in this milestone but is in an early development stage. Changing health status to 'at risk'.

Issue participants are welcome to override this by setting the health status to another value.

changed health status to at risk

@jaime Do you think this issue needs to carry over into 17.1? I'll update the issue. now but let me know if it should stay in 17.0

@trizzi yeah it's very likely given we were waiting for gitlab-org/charts/gitlab#5292 (closed) to be finalized. The good news is that issue has finally been closed

changed milestone to %17.1

mentioned in commit gitlab-org/charts/gitlab@c2f0c123

mentioned in issue #458781 (closed)

mentioned in merge request gitlab-org/charts/gitlab!3752 (merged)

Setting health status to on track as the milestone has just begun.

Issue participants are welcome to override this by setting the health status to another value.

changed health status to on track

mentioned in issue gitlab-org/quality/triage-reports#17715 (closed)

added Technical Writing docsfeature labels

mentioned in issue gitlab-org/quality/triage-reports#17797 (closed)

added workflowin review label and removed workflowin dev label

added to epic &5521

mentioned in commit gitlab-org/charts/gitlab@1fb0fa18

Status Update

• Complete: 99%
• Confidence: 95%

Notes:

• After multiple rounds of review, Registry: document three-step migration (gitlab-org/charts/gitlab!3752 - merged) it's finally in the last stages of review pending maintainer review from the docs team.
• Demo available https://youtu.be/HPHwskyfQoI

The docs have been merged Registry: document three-step migration (gitlab-org/charts/gitlab!3752 - merged)! And they're available now at https://docs.gitlab.com/charts/charts/registry/metadata_database.html#three-step-migration

Closing

closed

added workflowcomplete label and removed workflowin review label

mentioned in epic gitlab-org#5521