注意
本文档适用于 Ceph 的开发版本。
rbd-nbd -- 将 rbd 镜像映射到 nbd 设备
概要
rbd-nbd [-c conf] [--read-only] [--device nbd device] [--snap-id snap-id] [--nbds_max limit] [--max_part limit] [--exclusive] [--notrim] [--encryption-format format] [--encryption-passphrase-file passphrase-file] [--io-timeout seconds] [--reattach-timeout seconds] map image-spec | snap-spec
rbd-nbd unmap nbd device | image-spec | snap-spec
rbd-nbd list-mapped
rbd-nbd attach --device nbd device image-spec | snap-spec
rbd-nbd detach nbd device | image-spec | snap-spec
描述
rbd-nbd 是 RADOS 块设备 (rbd) 镜像的客户端，类似于 rbd 内核模块。它将 rbd 镜像映射到 nbd (网络块设备) 设备，允许将其作为常规本地块设备访问。
选项
- -c ceph.conf
使用 ceph.conf 配置文件代替默认的
/etc/ceph/ceph.conf来确定启动期间的监控器地址。
- --read-only
以只读方式映射。
- --nbds_max *limit*
覆盖 modprobe 时 NBD 内核模块的参数 nbds_max，用于限制 nbd 设备的数量。
- --max_part *limit*
覆盖模块参数 max_part。
- --exclusive
禁止其他客户端写入。
- --notrim
关闭 trim/discard。
- --encryption-format
镜像加密格式。可能的值：luks, luks1, luks2
- --encryption-passphrase-file
包含用于解锁镜像加密的密码短语的文件路径。
- --io-timeout *seconds*
覆盖设备超时。Linux 内核默认请求超时为 30 秒。允许用户选择指定不同的超时。
- --reattach-timeout *seconds*
指定内核在旧进程分离后等待新 rbd-nbd 进程连接的超时时间。默认值为 30 秒。
- --snap-id *snapid*
指定通过 ID 而不是名称来映射/解映射/附加/分离的快照。
镜像和快照规范
image-spec 是 [pool-name]/image-name
snap-spec 是 [pool-name]/image-name@snap-name
pool-name 的默认值是 “rbd”。如果镜像名称包含斜杠字符 (‘/’)，则需要 pool-name。
可用性
rbd-nbd 是 Ceph 的一部分，Ceph 是一个可大规模扩展的开源分布式存储系统。请参阅 Ceph 文档（网址为 https://docs.ceph.net.cn/）以获取更多信息。
另请参阅
rbd(8)