]> git.apps.os.sepia.ceph.com Git - ceph.git/commitdiff
doc/radosgw: edit cloud-transition (1 of x) 64024/head
authorZac Dover <zac.dover@proton.me>
Thu, 12 Jun 2025 11:28:57 +0000 (21:28 +1000)
committerZac Dover <zac.dover@proton.me>
Thu, 19 Jun 2025 04:56:15 +0000 (14:56 +1000)
Edit the first hundred lines of doc/radosgw/cloud-transition.rst.

Signed-off-by: Zac Dover <zac.dover@proton.me>
(cherry picked from commit 9ad5a65fe6cf883cf34bceae0314f55bcf599c96)

doc/radosgw/cloud-transition.rst

index 206a9b0192cc3de739a37aa7225d0fe57a1a5f8e..b030069f1e8a49466eda56a7791943f2259e4a1e 100644 (file)
@@ -2,17 +2,18 @@
 Cloud Transition
 ================
 
-This feature enables transitioning S3 objects to a remote cloud service as part
-of `object lifecycle <https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html>`_
+This feature makes it possible to transition S3 objects to a remote cloud
+service as part of the `object lifecycle
+<https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html>`_
 via :ref:`storage_classes`. The transition is unidirectional: data cannot be
-transitioned back from the remote zone. The goal of this feature is to enable
-data transition to multiple cloud providers. The currently supported cloud
-providers are those that are compatible with AWS (S3).
+transitioned back from the remote zone. The purpose of this feature is to
+enable data transition to multiple cloud providers. Cloud providers compatible
+with AWS (S3) are supported.
 
-A special storage class of tier type ``cloud-s3`` or ``cloud-s3-glacier``
-is used to configure the remote cloud S3 object store service to which
-data is transitioned. These are defined in terms of zonegroup placement
-targets and, unlike regular storage classes, do not need a data pool.
+We use a special storage class of tier type ``cloud-s3`` or
+``cloud-s3-glacier`` to configure the remote cloud S3 object store service to
+which data is transitioned. These classes are defined in terms of zonegroup
+placement targets and, unlike regular storage classes, do not need a data pool.
 
 User credentials for the remote cloud object store service must be
 configured. Note that source ACLs will not be preserved. It is possible
@@ -75,7 +76,8 @@ Cloud Transition Specific Configurables
 
 * ``host_style`` (path | virtual)
 
-  Type of host style to be used when accessing the remote cloud S3 service (default: ``path``).
+  Type of host style to be used when accessing the remote cloud S3 service
+  (default: ``path``).
 
 * ``acls`` (array)
 
@@ -83,9 +85,10 @@ Cloud Transition Specific Configurables
 
 * ``acl_mapping`` (container)
 
-  Each ``acl_mapping`` structure contains ``type``, ``source_id``, and ``dest_id``. These
-  define the ACL mutation to be done on each object. An ACL mutation makes it possible to
-  convert a source userid to a destination userid.
+  Each ``acl_mapping`` structure contains ``type``, ``source_id``, and
+  ``dest_id``. These define the ACL mutation to be done on each object. An ACL
+  mutation makes it possible to convert a source userid to a destination
+  userid.
 
 * ``type`` (id | email | uri)