Project

General

Profile

Documentation #58632

RGW Multisite documentation improvement project

Added by Zac Dover about 2 months ago. Updated about 1 month ago.

Status:
In Progress
Priority:
Normal
Assignee:
Target version:
-
% Done:

0%

Spent time:
Tags:
Backport:
Reviewed:
Affected Versions:
Pull request ID:

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? 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

Documentation #58649: line-edit all of doc/radosgw/multisite.rstIn ProgressZac Dover

RADOS - Documentation #58650: Write an overview of multisite.rst that explains to first-time readers what multisite is.Need More InfoZac Dover


Related issues

Related to Ceph - Documentation #57000: Improve RGW Getting Started Documentation New

History

#1 Updated by Zac Dover about 2 months ago

#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

#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"

Also available in: Atom PDF