Documentation #58632
RGW Multisite documentation improvement project
Description
https://docs.ceph.com/en/latest/radosgw/multisite/ starts with the description of new setups possible since Kraken. However, these changes already assume that the reader is familiar with the notions of zone, zonegroup, realm, period, and the related concepts. Clear definitions and a complete description of the data model should be provided upfront. In particular, to which level are buckets and users namespaced? What is replicated only across zones, and what is replicated across zonegroups? What is the use case for multiple zonegroups and/or realms? Why are there endpoints both on the zone level and on the zonegroup lenel - are they used for different purposes? If I run RADOS gateways behind a load balancer, is it the load balancer what I should specify as the endpoint? patrakov@gmail.com 2022-12-15
Define:
- Zone - https://docs.ceph.com/en/latest/radosgw/multisite/#zones
- Zonegroup - https://docs.ceph.com/en/latest/radosgw/multisite/#create-a-master-zone-group
- Realm - https://docs.ceph.com/en/latest/radosgw/multisite/#realms
- Period -
Which level are buckets and users namespaced to?
What is replicated across zones?
What is replicated across zonegroups?
What is the use case for multiple zonegroups?
What is the use case for multiple realms?
Why are there endpoints on both the zone level and the zonegroup level? Are these endpoints used for different purposes?
If RGW is run behind a load balancer, should the load balancer be specified as the endpoint?
Subtasks
Related issues
History
#1 Updated by Zac Dover about 2 months ago
https://github.com/ceph/ceph/pull/49981 - Refine "Zones" section
#2 Updated by Zac Dover about 2 months ago
https://github.com/ceph/ceph/pull/49993 - refine lines 1-50 of multisite.rst
#3 Updated by Zac Dover about 2 months ago
https://tracker.ceph.com/issues/58632 - edit lines ~50 - ~140 of multisite.rst.
#4 Updated by Neha Ojha about 2 months ago
- Project changed from RADOS to rgw
#5 Updated by Zac Dover about 2 months ago
- Assignee set to Zac Dover
#6 Updated by Zac Dover about 2 months ago
- Related to Documentation #57000: Improve RGW Getting Started Documentation added
#7 Updated by Zac Dover about 2 months ago
https://github.com/ceph/ceph/pull/50022 - Refine "Maintenance" in multisite.rst.
#8 Updated by Zac Dover about 2 months ago
https://github.com/ceph/ceph/pull/50030 - refine multisite.rst up to "Configure Secondary Zones"
#9 Updated by Zac Dover about 2 months ago
https://github.com/ceph/ceph/pull/50066 - edit "Configuring Secondary Zones"
#10 Updated by Zac Dover about 1 month ago
https://github.com/ceph/ceph/pull/50077 - edit "Failover and Disaster Recovery"
#11 Updated by Zac Dover about 1 month ago
https://github.com/ceph/ceph/pull/50086 - refine "Migrating Single-site System to Multi-site"
#12 Updated by Zac Dover about 1 month ago
https://github.com/ceph/ceph/pull/50108 - edit "Multi-site Configuration Reference"
#13 Updated by Zac Dover about 1 month ago
https://github.com/ceph/ceph/pull/50108 - edit "Multi-site Configuration Reference"