diff options
Diffstat (limited to 'doc/administration/packages/container_registry.md')
| -rw-r--r-- | doc/administration/packages/container_registry.md | 46 |
1 files changed, 8 insertions, 38 deletions
diff --git a/doc/administration/packages/container_registry.md b/doc/administration/packages/container_registry.md index bfeca7c56b9..281e2f275ec 100644 --- a/doc/administration/packages/container_registry.md +++ b/doc/administration/packages/container_registry.md @@ -1069,6 +1069,12 @@ end You can also [run cleanup on a schedule](../../user/packages/container_registry/reduce_container_registry_storage.md#cleanup-policy). +## Container registry metadata database **(FREE SELF BETA)** + +The metadata database enables many new registry features, including +online garbage collection, and increases the efficiency of many registry operations. +See the [Container registry metadata database](container_registry_metadata_database.md) page for details. + ## Container registry garbage collection NOTE: @@ -1260,11 +1266,11 @@ blobs start being deleted is anything permanent done. ### Continuous Zero Downtime Garbage Collection **(BETA)** You can run garbage collection in the background without the need to schedule it or require read-only mode, -if you migrate to the [metadata database (beta)](#use-a-postgresql-database-for-metadata). +if you migrate to the [metadata database (beta)](container_registry_metadata_database.md). NOTE: If you would like to try this [beta feature](../../policy/experiment-beta-support.md#beta), -you should review the [known limitations](#known-limitations). If you have any feedback, +you should review the [known limitations](container_registry_metadata_database.md#known-limitations). If you have any feedback, you can let us know in the [feedback issue](https://gitlab.com/gitlab-org/gitlab/-/issues/423459). ## Configure GitLab and Registry to run on separate nodes (Linux package installations) @@ -1368,42 +1374,6 @@ including all the supported storage backends. To migrate to the GitLab container you can follow the instructions on this page, and use the same storage backend as the Distribution Registry. The GitLab container registry should accept the same configuration that you are using for the Distribution Registry. -## Use a PostgreSQL database for metadata **(FREE SELF BETA)** - -> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/423459) in GitLab 16.4 as a [Beta feature](../../policy/experiment-beta-support.md) for self-managed GitLab instances. - -WARNING: -While the metadata database is already in use on GitLab.com, it is in early beta for self-managed GitLab instances. - -By default, the container registry uses object storage to persist metadata -related to container images. This method to store metadata limits how efficiently -the data can be accessed, especially data spanning multiple images, such as when listing tags. -By using a database to store this data, many new features are possible, including -[online garbage collection](https://gitlab.com/gitlab-org/container-registry/-/blob/master/docs/spec/gitlab/online-garbage-collection.md) -which removes old data automatically with zero downtime. - -This database works in conjunction with the object storage already used by the registry, but does not replace object storage. -You must continue to maintain an object storage solution even after migrating to a metadata database. - -### Known Limitations - -- No support for online migrations. -- Geo Support is not confirmed. -- Registry database migrations must be ran manually when upgrading versions. - -### Migration Instructions and Feedback - -Instructions on how to migrate to the database may be found in the [feedback issue](https://gitlab.com/gitlab-org/gitlab/-/issues/423459) for the beta period. -This issue also serves as a place to report issues and to get an overview of the beta status. - -### Metadata database feature support - -You can migrate existing registries to the metadata database, and use online garbage collection. - -Some database-enabled features are only enabled for GitLab.com and automatic database provisioning for -the registry database is not available. Review the feature support table in the [feedback issue](https://gitlab.com/gitlab-org/gitlab/-/issues/423459#supported-feature-status) -for the status of features related to the container registry database. - ## Troubleshooting Before diving in to the following sections, here's some basic troubleshooting: |