gitlab-org--gitlab-foss/doc/administration/geo/replication/object_storage.md
Marcel Amirault 73c6477b7e Changing badges to use parentheses not brackets
Previously, we used brackets to denote the tier badges,
but this made Kramdown, the docs site Markdown renderer,
show many warnings when building the site. This is now
fixed by using parentheses instead of square brackets.

This was caused by [PREMIUM] looking like a link to
Kramdown, which couldn't find a URL there.

See:
- https://gitlab.com/gitlab-com/gitlab-docs/merge_requests/484
- https://gitlab.com/gitlab-org/gitlab-ce/issues/63800
2019-07-08 08:50:38 +00:00

1.9 KiB

Geo with Object storage (PREMIUM ONLY)

Geo can be used in combination with Object Storage (AWS S3, or other compatible object storage).

Configuration

At this time it is required that if object storage is enabled on the primary node, it must also be enabled on each secondary node.

Secondary nodes can use the same storage bucket as the primary node, or they can use a replicated storage bucket. At this time GitLab does not take care of content replication in object storage.

For LFS, follow the documentation to set up LFS object storage.

For CI job artifacts, there is similar documentation to configure jobs artifact object storage

For user uploads, there is similar documentation to configure upload object storage

You should enable and configure object storage on both primary and secondary nodes. Migrating existing data to object storage should be performed on the primary node only. Secondary nodes will automatically notice that the migrated files are now in object storage.

Replication

When using Amazon S3, you can use CRR to have automatic replication between the bucket used by the primary node and the bucket used by secondary nodes.

If you are using Google Cloud Storage, consider using Multi-Regional Storage. Or you can use the Storage Transfer Service, although this only supports daily synchronization.

For manual synchronization, or scheduled by cron, please have a look at: