1
0
mirror of https://github.com/minio/docs.git synced 2025-07-31 18:04:52 +03:00

FIXUP: Existing object replication is on by default (#1206)

# Summary

We some time ago updated bucket replication to perform existing object
replication by default. Not entirely sure when, but long enough that we
can just make the change.

Also fixed one out-of-band syntax error.

# Staged


http://192.241.195.202:9000/staging/REPLFIX/linux/administration/bucket-replication.html#replication-of-existing-objects
This commit is contained in:
Ravind Kumar
2024-05-07 20:41:32 -04:00
committed by GitHub
parent 3399695e18
commit 9c8c089342
2 changed files with 10 additions and 34 deletions

View File

@ -176,45 +176,21 @@ application of object expiration.
Replication of Existing Objects Replication of Existing Objects
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
MinIO by default does not enable existing object replication. Objects MinIO by default replicates existing objects in the source bucket to the configured remote, similar to `AWS: Replicating existing objects between S3 buckets <https://aws.amazon.com/blogs/storage/replicating-existing-objects-between-s3-buckets/>`__ without the overhead of contacting technical support.
created before replication was configured *or* while replication is
disabled are not synchronized to the target deployment.
MinIO supports enabling replication of existing objects in a bucket.
Enabling existing object replication marks all objects or object prefixes that MinIO marks all objects or object prefixes that satisfy the replication rules as eligible for synchronization to the remote cluster and bucket.
satisfy the replication rules as eligible for synchronization to the source MinIO only excludes those objects without a version ID, such as those objects written before enabling versioning on the bucket.
cluster, *even if* those objects were created prior to configuring or enabling
replication. You can enable existing object replication while configuring
or modifying a replication rule:
- For new replication rules, include ``"existing-objects"`` to the list of You can disable existing object replication while configuring or modifying the bucket replication rule.
replication features specified to :mc-cmd:`mc replicate add --replicate`. You must specify *all* desired replication features during creation or modification:
- For existing replication rules, add ``"existing-objects"`` to the list of - For new replication rules, exclude ``"existing-objects"`` from the list of replication features specified to :mc-cmd:`mc replicate add --replicate`.
existing replication features using
:mc-cmd:`mc replicate update --replicate`. You must specify *all* desired
replication features when editing the replication rule.
Enabling existing object replication does not increase the priority of objects - For existing replication rules, remove ``"existing-objects"`` from the list of existing replication features using :mc-cmd:`mc replicate update --replicate`.
pending replication. MinIO uses the same core The new rule **replaces** the previous rule.
:ref:`replication scanner and queue system <minio-replication-process>` for
detecting and synchronizing objects regardless of the enabled replication
feature. The time required to fully synchronize a bucket depends on a number of
factors, including but not limited to the current cluster replication load,
overall cluster load, and the size of the namespace (all objects in the bucket).
.. include:: /includes/common/scanner.rst Disabling existing object replication does not remove any objects already replicated to the remote bucket.
:start-after: start-scanner-speed-config
:end-before: end-scanner-speed-config
If versioning was not previously enabled when configuring bucket replication,
existing objects have a ``versionid = null``. These objects do replicate.
MinIO existing object replication
implements functionality similar to
`AWS: Replicating existing objects between S3 buckets
<https://aws.amazon.com/blogs/storage/replicating-existing-objects-between-s3-buckets/>`__
without the overhead of contacting technical support.
Synchronous vs Asynchronous Replication Synchronous vs Asynchronous Replication
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

View File

@ -10,7 +10,7 @@ Key Encryption Service Settings
:local: :local:
:depth: 2 :depth: 2
.. |SSE| replace:: :abbr:`SSE (Server-Side Encryption)` .. |SSE| replace:: :abbr:`SSE (Server-Side Encryption)`
The following environment variables control how the MinIO Server interacts with the Key Encryption Service (KES) when managing encryption and keys. The following environment variables control how the MinIO Server interacts with the Key Encryption Service (KES) when managing encryption and keys.