Project

General

Profile

Actions

Documentation #58632

open

RGW Multisite documentation improvement project

Added by Zac Dover about 1 year ago. Updated about 1 year 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 2 (2 open0 closed)

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

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

Actions

Related issues 1 (1 open0 closed)

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

Actions
Actions #1

Updated by Zac Dover about 1 year ago

Actions #2

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/49993 - refine lines 1-50 of multisite.rst

Actions #3

Updated by Zac Dover about 1 year ago

https://tracker.ceph.com/issues/58632 - edit lines ~50 - ~140 of multisite.rst.

Actions #4

Updated by Neha Ojha about 1 year ago

  • Project changed from RADOS to rgw
Actions #5

Updated by Zac Dover about 1 year ago

  • Assignee set to Zac Dover
Actions #6

Updated by Zac Dover about 1 year ago

Actions #7

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/50022 - Refine "Maintenance" in multisite.rst.

Actions #8

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/50030 - refine multisite.rst up to "Configure Secondary Zones"

Actions #9

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/50066 - edit "Configuring Secondary Zones"

Actions #10

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/50077 - edit "Failover and Disaster Recovery"

Actions #11

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/50086 - refine "Migrating Single-site System to Multi-site"

Actions #12

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/50108 - edit "Multi-site Configuration Reference"

Actions #13

Updated by Zac Dover about 1 year ago

https://github.com/ceph/ceph/pull/50108 - edit "Multi-site Configuration Reference"

Actions

Also available in: Atom PDF