Documentation #57001: RBD Rewrite Project - Ceph - Ceph

Actions

Copy link

Documentation #57001

open

RBD Rewrite Project

Added by Zac Dover over 1 year ago. Updated over 1 year ago.

Status:

In Progress

Priority:

Normal

Assignee:

Zac Dover

Category:

documentation

Target version:

% Done:

Spent time:

2:00 h

Tags:

Backport:

Reviewed:

Affected Versions:

Pull request ID:

Description

Josh Durgin and Zac Dover decided on 29 Jul 2022 that the RBD Documentation should be organized more like the CephFS documentation. This should involve a short document that provides a basic overview of RBD.

Actions

Copy link

Updated by Zac Dover over 1 year ago

https://docs.ceph.com/en/quincy/rbd/

Actions

Copy link

Updated by Cole Mitchell over 1 year ago

As of 16 Nov 2022 AEST, the front matter of the RBD book reads as follows:

A block is a sequence of bytes (often 512). Block-based storage interfaces are a mature and common way to store data on media including HDDs, SSDs, CDs, floppy disks, and even tape. The ubiquity of block device interfaces is a perfect fit for interacting with mass data storage including Ceph.

Ceph block devices are thin-provisioned, resizable, and store data striped over multiple OSDs. Ceph block devices leverage RADOS capabilities including snapshotting, replication and strong consistency. Ceph block storage clients communicate with Ceph clusters through kernel modules or the librbd library.

Ceph’s block devices deliver high performance with vast scalability to kernel modules, or to KVMs such as QEMU, and cloud-based computing systems like OpenStack and CloudStack that rely on libvirt and QEMU to integrate with Ceph block devices. You can use the same cluster to operate the Ceph RADOS Gateway, the Ceph File System, and Ceph block devices simultaneously.

Actions

Copy link

Updated by Zac Dover over 1 year ago

https://medium.com/system-design-blog/eventual-consistency-vs-strong-consistency-b4de1f92534d - A medium.com article describing the difference between "strong consistency" and "immediate consistency".

Actions

Copy link

Updated by Zac Dover over 1 year ago

https://github.com/ceph/ceph/pull/49035

This PR swaps the order of the first two paragraphs in the front matter.

This sentence remains in need of a rewrite: "The ubiquity of block device interfaces is a perfect fit for interacting with mass data storage including Ceph.". I doubt that block device interfaces' ubiquity is what makes block device interfaces a perfect fit for interacting with mass data storage. I suspect rather that block device interfaces are generally available and are likely to be familiar or easily learned.

Actions

Copy link

Updated by Zac Dover over 1 year ago

Subject changed from Improve RBD Getting Started Documentation to RBD Rewrite Project
Category set to documentation
Status changed from New to In Progress

Many semantic errors are present in the text of the RBD documentation as of 06 Dec 2022. Each of the files in the doc/rbd/ directory could be improved by an editorial pass focused on the semantics of the text.

Actions

Copy link