rbd – 管理 RADOS 块设备（ RBD ）映像¶

提纲¶

rbd [ -c ceph.conf ] [ -m monaddr ] [–cluster cluster-name] [ -p | –pool pool ] [ command … ]

描述¶

rbd 是个修改 rados 块设备（ RBD ）映像的工具， QEMU/KVM 通过 Linux 内核驱动和 rbd 存储驱动使用 RBD 。 RBD 映像是简单的块设备，它被条带化成小块对象后存储于 RADOS 对象存储集群，条带化后的对象尺寸必须是 2 的幂。

选项¶

-c ceph.conf, --conf ceph.conf¶: 指定 ceph.conf 配置文件，而不是用默认的 /etc/ceph/ceph.conf 来确定启动时需要的监视器。

-m monaddress[:port]¶: 连接到指定监视器，无需通过 ceph.conf 查找。

--cluster cluster-name¶: 使用非默认的集群名字，即不是 ceph 的集群名。

-p pool-name, --pool pool-name¶: 在指定存储池下操作，大多数命令都得指定。

--namespace namespace-name¶: 使用存储池内一个预定义的映像命名空间。

--no-progress¶: 不显示进度（有些命令会默认输出到标准输出）。

参数¶

--image-format format-id¶

选择用哪个对象布局，默认为 2 。

format 1 - （已废弃）新建 rbd 映像时使用最初的格式。此格式兼容所有版本的 librbd 和内核模块，但是不支持较新的功能，像克隆。
format 2 - 使用第二版 rbd 格式， librbd 和 3.11 版以上内核模块才支持（除非是分拆的模块）。此格式增加了克隆支持，使得扩展更容易，还允许以后增加新功能。

-s size-in-M/G/T, --size size-in-M/G/T¶: 指定新 rbd 映像、或是已有 rbd 映像的新尺寸，单位可以是 M/G/T ，没加后缀的话默认为 M 。

--object-size size-in-B/K/M¶: 指定对象尺寸，单位可以是 B/K/M 。对象尺寸将被对齐到最接近的 2 的幂；如果不指定后缀，则认为单位是 B 。默认的对象尺寸是 4MB ，最小允许 4K 、最大允许 32M 。

--stripe-unit size-in-B/K/M¶: 指定条带单元尺寸，单位可以是 B/K/M ，没加的话默认为 B 。详情见下面的条带化一段。

--stripe-count num¶: 条带化要至少跨越多少对象才能转回第一个。详情见条带化一节。

--snap snap¶: 某些操作需要指定快照名。

--id username¶: 指定 map 命令要用到的用户名（不含 client. 前缀）。

--keyring filename¶: 因 map 命令所需，指定一个用户及其密钥文件。如果未指定，从默认密钥环里找。

--keyfile filename¶: 因 map 命令所需，给 --id user 用户指定一个包含密钥的文件。如果同时指定了 --keyring 选项，本选项就会被覆盖。

--shared lock-tag¶: lock add 命令的选项，它允许使用同一标签的多个客户端同时锁住同一映像。标签是任意字符串。当某映像必须从多个客户端同时打开时，此选项很有用，像迁移活动虚拟机时、或者在集群文件系统下使用时。

--format format¶: 指定输出格式，默认： plain 、 json 、 xml 。

--pretty-format¶: 使 json 或 xml 格式的输出更易读。

-o krbd-options, --options krbd-options¶: 通过 rbd 内核驱动映射或取消映射某一映像时指定的选项。 krbd-options 是逗号分隔的一系列选项（类似于 mount(8) 的挂载选项）。详情见下面的内核 rbd (krbd) 选项一段。

--read-only¶: 以只读方式映射到映像，等价于 -o ro 。

--image-feature feature-name¶

创建格式 2 的 RBD 映像时，指定要启用哪些功能。想要启用多个功能的话，可以多次重复使用此选项。当前支持下列功能：

layering: 支持分层
striping: 支持条带化 v2
exclusive-lock: 支持独占锁
object-map: 支持对象映射（依赖 exclusive-lock ）
fast-diff: 快速计算差异（依赖 object-map ）
deep-flatten: 支持快照扁平化操作
journaling: 支持记录 IO 操作（依赖独占锁）
data-pool: 纠删码存储池支持

--image-shared¶: 指定该映像将被多个客户端同时使用。此选项将禁用那些依赖于独占所有权的功能。

--whole-object¶: 把 diff 操作范围限定在完整的对象条带级别，而非对象内差异。当某一映像启用了 object-map 功能时，把 diff 操作限定到对象条带会显著地提高性能，因为通过检查驻留于内存中的对象映射就可以计算出差异，而无需针对映像内的各个对象查询 RADOS 。

--limit¶: 指定快照的数量上限。

命令¶

bench –io-type <read | write | readwrite | rw> [–io-size size-in-B/K/M/G/T] [–io-threads num-ios-in-flight] [–io-total size-in-B/K/M/G/T] [–io-pattern seq | rand] [–rw-mix-read read proportion in readwrite] image-spec

向指定映像生成一系列 IO 操作，以此衡量 IO 吞吐量和延时。如果不加后缀， –io-size 和 –io-total 的单位就当是 B 。默认参数为 –io-size 4096 、 –io-threads 16 、 –io-total 1G 、 –io-pattern seq 、 –rw-mix-read 50 。

children snap-spec

列出此映像指定快照的克隆品。它会检查各存储池、并输出存储池名/映像名。

只适用于 format 2 。

clone [–object-size size-in-B/K/M] [–stripe-unit size-in-B/K/M –stripe-count num] [–image-feature feature-name] [–image-shared] parent-snap-spec child-image-spec

创建一个父快照的克隆品（写时复制子映像）。若不指定，对象尺寸将与父映像完全一样。尺寸和父快照一样。参数 –stripe-unit 和 –stripe-count 是可选的，但必须同时使用。

父快照必须已被保护（见 rbd snap protect ）。 format 2 格式的映像才支持。

config global get config-entity key

Get a global-level configuration override.

config global list [–format plain | json | xml] [–pretty-format] config-entity

List global-level configuration overrides.

config global set config-entity key value

Set a global-level configuration override.

config global remove config-entity key

Remove a global-level configuration override.

config image get image-spec key

Get an image-level configuration override.

config image list [–format plain | json | xml] [–pretty-format] image-spec

List image-level configuration overrides.

config image set image-spec key value

Set an image-level configuration override.

config image remove image-spec key

Remove an image-level configuration override.

config pool get pool-name key

Get a pool-level configuration override.

config pool list [–format plain | json | xml] [–pretty-format] pool-name

List pool-level configuration overrides.

config pool set pool-name key value

Set a pool-level configuration override.

config pool remove pool-name key

Remove a pool-level configuration override.

cp (src-image-spec | src-snap-spec) dest-image-spec

把源映像内容复制进新建的目标映像，目标映像和源映像将有相同的尺寸、对象尺寸和格式。

create (-s | –size size-in-M/G/T) [–image-format format-id] [–object-size size-in-B/K/M] [–stripe-unit size-in-B/K/M –stripe-count num] [–thick-provision] [–no-progress] [–image-feature feature-name]… [–image-shared] image-spec

新建一个 rbd 映像。还必须用 –size 指定尺寸。 –strip-unit 和 –strip-count 参数是可选项，但必须一起用。如果加了 –thick-provision 选项，它会在创建时就为映像分配所需的所有存储空间，需要很长时间完成。注意：全配（ thick provisioning ）要求把整个映像的内容都清零。

deep cp (src-image-spec | src-snap-spec) dest-image-spec

把 src-image 的内容深复制到新建的 dest-image 。 dest-image 将会有和 src-image 相同的尺寸、对象尺寸、映像格式、和快照。

device list [-t | –device-type device-type] [–format plain | json | xml] –pretty-format

展示通过 rbd 内核模块映射的 rbd 映像（默认的）或其它支持的设备。

device map [-t | –device-type device-type] [–read-only] [–exclusive] [-o | –options device-options] image-spec | snap-spec

把指定映像通过 rbd 内核模块映射成一个块设备（默认的）、或其它支持的设备（ Linux 上的 nbd 或 FreeBSD 上的 ggate ）。

–options 参数是个逗号分隔的特定于某类型设备的一系列选项（ opt1,opt2=val,… ）。

device unmap [-t | –device-type device-type] [-o | –options device-options] image-spec | snap-spec | device-path

断开块设备映射，之前通过 rbd 内核模块映射的（默认的）、或其它支持的设备。

–options 参数是个逗号分隔的特定于某类型设备的一系列选项（ opt1,opt2=val,… ）。

diff [–from-snap snap-name] [–whole-object] image-spec | snap-spec

打印出从指定快照点起、或从映像创建点起，映像内的变动区域。输出的各行都包含起始偏移量（按字节）、数据块长度（按字节）、还有 zero 或 data ，用来指示此范围以前是 0 还是其它数据。

du [-p | –pool pool-name] [image-spec | snap-spec]

会计算指定存储池内所有映像及其相关快照的磁盘使用量，包括分配的和实际使用的。此命令也可用于单个映像和快照。

如果 RBD 映像的 fast-diff 特性没启用，本操作就需要向各个 OSD 挨个查询此映像涉及的每个潜在对象。

export [–export-format format (1 or 2)] (image-spec | snap-spec) [dest-path]

把映像导出到目的路径，用 - （短线）输出到标准输出。 –export-format 现在只认 ‘1’ 或 ‘2’ 。格式 2 不仅允许我们导出映像内容，还可以导出快照和其它属性，如 image_order 、功能标志。

export-diff [–from-snap snap-name] [–whole-object] (image-spec | snap-spec) dest-path

导出一映像的增量差异，用-导出到标准输出。若给了起始快照，就只包含与此快照的差异部分；否则包含映像的所有数据部分；结束快照用 –snap 选项或 @snap （见下文）指定。此映像的差异格式包含了映像尺寸变更的元数据、起始和结束快照，它高效地表达了被忽略或映像内的全 0 区域。

feature disable image-spec feature-name…

禁用指定镜像的某些功能，可以一次指定多个功能。

feature enable image-spec feature-name…

启用指定镜像的某些功能，可以一次指定多个功能。

flatten image-spec

如果映像是个克隆品，就从父快照拷贝所有共享块，并使子快照独立于父快照、切断父子快照间的链接。如果没有克隆品引用此父快照了，就可以取消保护并删除。

只适用于 format 2 。

group create group-spec

创建一个组。

group image add group-spec image-spec

把一个映像加入某一组。

group image list group-spec

罗列一个组内的映像。

group image remove group-spec image-spec

删除一个组内的对象。

group ls [-p | –pool pool-name]

罗列所有 rbd 组。

group rename src-group-spec dest-group-spec

重命名一个组。注意：不支持跨存储池重命名。

group rm group-spec

删除一个组。

group snap create group-snap-spec

创建一个组的快照。

group snap list group-spec

罗列一个组的快照。

group snap rm group-snap-spec

删除一个组的某一快照。

group snap rename group-snap-spec snap-name

重命名组的快照。

group snap rollback group-snap-spec

把组回滚到某快照。

image-meta get image-spec key

获取关键字对应的元数据值。

image-meta list image-spec

显示此映像持有的元数据。第一列是关键字、第二列是值。

image-meta remove image-spec key

删除元数据关键字及其值。

image-meta set image-spec key value

设置指定元数据关键字的值，会显示在 metadata-list 中。

import [–export-format format (1 or 2)] [–image-format format-id] [–object-size size-in-B/K/M] [–stripe-unit size-in-B/K/M –stripe-count num] [–image-feature feature-name]… [–image-shared] src-path [image-spec]

创建一映像，并从目的路径导入数据，用 - （短线）从标准输入导入。如果可能的话，导入操作会试着创建稀疏映像。如果从标准输入导入，稀疏化单位将是目标映像的数据块尺寸（即对象尺寸）。

参数 –stripe-unit 和 –stripe-count 是可选的，但必须同时使用。

–export-format 现在只认 ‘1’ 或 ‘2’ 。格式 2 不仅允许我们导出映像内容，还可以导出快照和其它属性，如 image_order 、功能标志。

import-diff src-path image-spec

导入一映像的增量差异并应用到当前映像。如果此差异是在起始快照基础上生成的，我们会先校验那个已存在快照再继续；如果指定了结束快照，我们先检查它是否存在、再应用变更，结束后再创建结束快照。

info image-spec | snap-spec

显示指定 rbd 映像的信息（如大小和对象尺寸）。若映像是克隆品，会显示相关父快照；若指定了快照，会显示是否被保护。

journal client disconnect journal-spec

把映像日志客户端标记为连接已断。

journal export [–verbose] [–no-error] src-journal-spec path-name

把映像日志导出到指定路径（ - 导出到标准输出 stdout ）。它可以作为映像日志的备份手段，特别是打算做危险的操作前。

注意，如果日志损坏严重，此命令有可能失效。

journal import [–verbose] [–no-error] path-name dest-journal-spec

从指定路径导入映像日志（ - 从标准输入 stdin 导入）。

journal info journal-spec

展示映像日志的信息。

journal inspect [–verbose] journal-spec

检查并报告映像日志的结构性错误。

journal reset journal-spec

重置映像日志。

journal status journal-spec

展示映像日志的状态。

lock add [–shared lock-tag] image-spec lock-id

为映像加锁，锁标识是用户一己所好的任意名字。默认加的是互斥锁，也就是说如果已经加过锁的话此命令会失败； –shared 选项会改变此行为。注意，加锁操作本身不影响除加锁之外的任何操作，也不会保护对象、防止它被删除。

lock list image-spec

显示锁着映像的锁，第一列是 lock remove 可以使用的锁名。

lock remove image-spec lock-id locker

释放映像上的锁。锁标识和其持有者来自 lock ls 。

ls [-l | –long] [pool-name]

列出 rbd_directory 对象中的所有 rbd 映像。加 -l 选项后也显示快照，并用长格式输出，包括大小、父映像（若是克隆品）、格式等等。

如果 RBD 映像的 fast-diff 功能没启用，那么这个操作需向多个 OSD 查询此映像涉及的每个对象。

merge-diff first-diff-path second-diff-path merged-diff-path

把两个连续的增量差异合并为单个差异。前一个差异的末尾快照必须与后一个差异的起始快照相同。前一个差异可以是标准输入 - ，合并后的差异可以是标准输出 - ；这样就可以合并多个差异文件，像这样： ‘rbd merge-diff first second - | rbd merge-diff - third result’ 。注意，当前此命令只支持 stripe_count == 1 这样的源增量差异。

migration abort image-spec

Cancel image migration. This step may be run after successful or failed migration prepare or migration execute steps and returns the image to its initial (before migration) state. All modifications to the destination image are lost.

migration commit image-spec

Commit image migration. This step is run after a successful migration prepare and migration execute steps and removes the source image data.

migration execute image-spec

Execute image migration. This step is run after a successful migration prepare step and copies image data to the destination.

migration prepare [–order order] [–object-size object-size] [–image-feature image-feature] [–image-shared] [–stripe-unit stripe-unit] [–stripe-count stripe-count] [–data-pool data-pool] src-image-spec [dest-image-spec]

Prepare image migration. This is the first step when migrating an image, i.e. changing the image location, format or other parameters that can’t be changed dynamically. The destination can match the source, and in this case dest-image-spec can be omitted. After this step the source image is set as a parent of the destination image, and the image is accessible in copy-on-write mode by its destination spec.

mirror image demote image-spec

把 RBD 映像中的主映像降级成非主映像。

mirror image disable [–force] image-spec

Disable RBD mirroring for an image. If the mirroring is configured in image mode for the image’s pool, then it can be explicitly disabled mirroring for each image within the pool.

mirror image enable image-spec

Enable RBD mirroring for an image. If the mirroring is configured in image mode for the image’s pool, then it can be explicitly enabled mirroring for each image within the pool.

This requires the RBD journaling feature is enabled.

mirror image promote [–force] image-spec

Promote a non-primary image to primary for RBD mirroring.

mirror image resync image-spec

Force resync to primary image for RBD mirroring.

mirror image status image-spec

Show RBD mirroring status for an image.

mirror pool demote [pool-name]

Demote all primary images within a pool to non-primary. Every mirroring enabled image will demoted in the pool.

mirror pool disable [pool-name]

Disable RBD mirroring by default within a pool. When mirroring is disabled on a pool in this way, mirroring will also be disabled on any images (within the pool) for which mirroring was enabled explicitly.

mirror pool enable [pool-name] mode

Enable RBD mirroring by default within a pool. The mirroring mode can either be pool or image. If configured in pool mode, all images in the pool with the journaling feature enabled are mirrored. If configured in image mode, mirroring needs to be explicitly enabled (by mirror image enable command) on each image.

mirror pool info [pool-name]

Show information about the pool mirroring configuration. It includes mirroring mode, peer UUID, remote cluster name, and remote client name.

mirror pool peer add [pool-name] remote-cluster-spec

Add a mirroring peer to a pool. remote-cluster-spec is [remote client name@]remote cluster name.

The default for remote client name is “client.admin”.

This requires mirroring mode is enabled.

mirror pool peer remove [pool-name] uuid

Remove a mirroring peer from a pool. The peer uuid is available from mirror pool info command.

mirror pool peer set [pool-name] uuid key value

Update mirroring peer settings. The key can be either client or cluster, and the value is corresponding to remote client name or remote cluster name.

mirror pool promote [–force] [pool-name]

Promote all non-primary images within a pool to primary. Every mirroring enabled image will promoted in the pool.

mirror pool status [–verbose] [pool-name]

Show status for all mirrored images in the pool. With –verbose, also show additionally output status details for every mirroring image in the pool.

mv src-image-spec dest-image-spec

映像改名。注：不支持跨存储池。

namespace create pool-name/namespace-name

在存储池内新建一个映像命名空间。

namespace list pool-name

罗列存储池内定义的映像命名空间。

namespace remove pool-name/namespace-name

从存储池删除一个空的映像命名空间。

object-map check image-spec | snap-spec

核验对象映射图是否正确。

object-map rebuild image-spec | snap-spec

为指定映像重建无效的对象映射关系。指定映像快照时，将为此快照重建无效的对象映射关系。

pool init [pool-name] [–force]

初始化用于 RBD 的存储池。新建的存储池必须先初始化才能使用。

resize (-s | –size size-in-M/G/T) [–allow-shrink] image-spec

rbd 大小调整。尺寸参数必须指定； –allow-shrink 选项允许缩小。

rm image-spec

删除一 rbd 映像，包括所有数据块。如果映像有快照，此命令会失效。

snap create snap-spec

新建一快照。需指定快照名。

snap limit clear image-spec

清除先前设置的映像所允许的快照数量上限。

snap limit set [–limit] limit image-spec

设置一个映像所允许的快照数量上限。

snap ls image-spec

列出一映像内的快照。

snap protect snap-spec

保护快照，防删除，这样才能从它克隆（见 rbd clone ）。做克隆前必须先保护快照，保护意味着克隆出的子快照依赖于此快照。 rbd clone 不能在未保护的快照上操作。

只适用于 format 2 。

snap purge image-spec

删除一映像的所有未保护快照。

snap rename src-snap-spec dest-snap-spec

重命名一个快照。注意：不支持跨存储池和跨映像重命名。

snap rm [–force] snap-spec

删除指定快照。

snap rollback snap-spec

把指定映像回滚到快照。此动作会递归整个块阵列，并把数据头内容更新到快照版本。

snap unprotect snap-spec

取消对快照的保护（撤销 snap protect ）。如果还有克隆出的子快照尚在， snap unprotect 命令会失效。（注意克隆品可能位于不同于父快照的存储池。）

只适用于 format 2 。

sparsify [–sparse-size sparse-size] image-spec

回收已被清零的映像条带所占的空间。默认的稀疏尺寸为 4096 字节，可用 –sparse-size 选项更改，但有这些限制条件：它应该是 2 幂、不小于 4096 、且不大于映像的对象尺寸。

status image-spec

显示映像状态，包括哪个客户端打开着它。

trash ls [pool-name]

罗列垃圾桶内的所有条目。

trash mv image-spec

把映像移入垃圾桶。所有映像，包括正被克隆件引用的，都能被移入垃圾桶，而后删除。

trash purge [pool-name]

删除垃圾桶内所有过期的映像。

trash restore image-id

从垃圾桶恢复一个映像。

trash rm image-id

从垃圾桶删除一个映像。如果映像的延期时间尚未满，那就不能删除，除非强删。但是正被克隆件引用的、或还有快照的删不掉。

watch image-spec

盯着有关此映像的事件。

映像、快照、组和日志的名称规范¶

image-spec is [pool-name]/image-name
snap-spec  is [pool-name]/image-name@snap-name
group-spec      is [pool-name/[namespace-name/]]group-name
group-snap-spec is [pool-name/[namespace-name/]]group-name@snap-name
journal-spec    is [pool-name/[namespace-name/]]journal-name

pool-name 的默认值是 rbd 、 namespace-name 默认是 “” （为空）。如果某个映像名包含斜杠字符（ / ），那么还必须指定 pool-name 。

journal-name 是 image-id 。

你可以用 –pool 、 –namespace 、 –image 和 –snap 选项分别指定各个名字，但是不鼓励这样用，大家还是倾向于上面的规范语法。

条带化¶

RBD 映像被条带化为很多对象，然后存储到 Ceph 分布式对象存储（ RADOS ）集群中。因此，到此映像的读和写请求会被分布到集群内的很多节点，也因此避免了映像巨大或繁忙时可能出现的单节点瓶颈。

条带化由三个参数控制：

object-size¶: 条带化产生的对象尺寸是 2 的幂，它会被对齐到最接近的 2 的幂。默认对象尺寸是 4MB ，最小是 4K 、最大 32 M 。

stripe_unit¶: 各条带单位是连续的字节，相邻地存储于同一对象，用满再去下一个对象。

stripe_count¶: 我们把 [stripe_unit] 个字节写够 [stripe_count] 个对象后，再转回到第一个对象写另一轮条带，直到达到对象的最大尺寸。此时，我们继续写下一轮 [stripe_count] 个对象。

默认情况下， [stripe_unit] 和对象尺寸相同、且 [stripe_count] 为 1 ；另外指定 [stripe_unit] 需 STRIPINGV2 功能（ Ceph 0.53 起加入）并使用 format 2 格式的映像。

内核 rbd (krbd) 选项¶

这里的大多数选项主要适用于调试和压力测试。默认值设置于内核中，因此还与所用内核的版本有关。

每个客户端例程的 rbd device map 选项：

fsid=aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee - 应该由客户端提供的 FSID 。
ip=a.b.c.d[:p] - IP 还有客户端可选的端口。
share - 允许与其它映射共享客户端例程（默认）。
noshare - 禁止与其它映射共享客户端例程。
crc - 启用在写入数据时计算 CRC32C 校验值（默认）。
nocrc - 在写入数据时不计算 CRC32C 校验值。
cephx_require_signatures - 要求对 cephx 消息签名（从 3.19 起默认开启）。
nocephx_require_signatures - 不要求对 cephx 消息签名（从 3.19 起）。
tcp_nodelay - 在客户端禁用 Nagle’s 算法（从 4.0 起默认开启）。
notcp_nodelay - 在客户端启用 Nagle’s 算法（从 4.0 起）。
cephx_sign_messages - 启用消息签名（从 4.4 起默认开启）。
nocephx_sign_messages - 禁用消息签名（从 4.4 起）。
mount_timeout=x - 执行 rbd device map 和 rbd device unmap 时所涉及的各操作步骤的超时值（默认为 60 秒）。特别是从 4.2 起，与集群间没有连接时，即认为 rbd device unmap 操作超时了。
osdkeepalive=x - OSD 保持连接的期限（默认为 5 秒）。
osd_idle_ttl=x - OSD 闲置 TTL （默认为 60 秒）。

每个映射（块设备）的 rbd device map 选项：

rw - 以读写方式映射映像（默认）。
ro - 以只读方式映射映像，等价于 –read-only 。
queue_depth=x - 队列深度（从 4.2 起默认为 128 个请求）。
lock_on_read - 除写入和 discard 操作外，读取时也要获取独占锁（从 4.9 起）。
exclusive - 禁止自动转换互斥锁（从 4.12 起）。
lock_timeout=x - 获取互斥锁的超时时长（ 4.17 起支持，默认是 0 秒，意味着没有超时）。
notrim - 关闭 discard 、和填 0 功能，以免全配映像的空间被收回（从 4.17 起支持）。启用后， discard 请求会以 -EOPNOTSUPP 代码失败，填 0 请求会回退成手动填 0 。
abort_on_full - 在集群空间用尽或数据存储池用完配额时让写请求以 -ENOSPC 代码失败（从 5.0 起支持）。默认行为是阻塞着，直到占满条件释放。
alloc_size - OSD 底层对象存储后端的最小分配单元（从 5.1 起支持，默认为 64KB ）。这是用于对齐数据块和丢弃太小的 discard 操作。对于 bluestore ，推荐的配置是 bluestore_min_alloc_size （一般来说，硬盘是 64K 、 SSD 是 16K ）； filestore 用 filestore_punch_hole = false 配置，推荐的配置是映像对象尺寸（一般是 4M ）。

rbd device unmap 选项：

force - 让某一已打开的块设备强制取消映射（从 4.9 起支持）。其驱动会等待当前的请求完成之后再 unmap ；在 unmap 初始化之后再发给驱动的请求会失败。

实例¶

要新建一 100GB 的 rbd 映像：

rbd create mypool/myimage --size 102400

用个非默认对象尺寸，8 MB：

rbd create mypool/myimage --size 102400 --object-size 8M

删除一 rbd 映像（谨慎啊！）：

rbd rm mypool/myimage

新建快照：

rbd snap create mypool/myimage@mysnap

创建已保护快照的写时复制克隆：

rbd clone mypool/myimage@mysnap otherpool/cloneimage

查看快照有哪些克隆品：

rbd children mypool/myimage@mysnap

删除快照：

rbd snap rm mypool/myimage@mysnap

启用 cephx 时通过内核映射一映像：

rbd device map mypool/myimage --id admin --keyfile secretfile

要通过内核把某一映像映射到没用默认名字 ceph 的集群：

rbd device map mypool/myimage --cluster cluster-name

取消映像映射：

rbd device unmap /dev/rbd0

创建一映像及其克隆品：

rbd import --image-format 2 image mypool/parent
rbd snap create mypool/parent@snap
rbd snap protect mypool/parent@snap
rbd clone mypool/parent@snap otherpool/child

新建一 stripe_unit 较小的映像（在某些情况下可更好地分布少量写）：

rbd create mypool/myimage --size 102400 --stripe-unit 65536B --stripe-count 16

更改一映像的格式，先导出、再导入为期望格式：

rbd export mypool/myimage@snap /tmp/img
rbd import --image-format 2 /tmp/img mypool/myimage2

互斥地锁住一映像：

rbd lock add mypool/myimage mylockid

释放锁：

rbd lock remove mypool/myimage mylockid client.2485

罗列垃圾桶里的映像：

rbd trash ls mypool

推迟删除一个映像（用 –expires-at 设置一个过期时间，默认是现在）：

rbd trash mv mypool/myimage --expires-at "tomorrow"

从垃圾桶删除一个映像（谨慎啊！）：

rbd trash rm mypool/myimage-id

从垃圾桶强行删除一个映像（谨慎啊！）：

rbd trash rm mypool/myimage-id  --force

从垃圾桶恢复一个映像：

rbd trash restore mypool/myimage-id

从垃圾桶恢复一个映像、并给它改个名字：

rbd trash restore mypool/myimage-id --image mynewimage

使用范围¶

rbd 是 Ceph 的一部分，这是个伸缩力强、开源、分布式的存储系统，更多信息参见 http://ceph.com/docs 。

参考¶

ceph(8), rados(8)