注意
本文档适用于 Ceph 的开发版本。
ZFS
ceph-volume zfs 的后端是 ZFS,它严重依赖于标签的使用,标签是 ZFS 允许扩展其卷元数据的一种方式。这些值稍后可以针对设备进行查询,这也是它们稍后被发现的方式。
目前,此接口仅在 FreeBSD 上运行时可用。
警告
这些 API 不旨在公开,但会进行文档记录,以便清楚地了解该工具在后台所做的工作。请勿更改任何这些值。
标签 API
将文件系统、卷和池识别为 Ceph 的一部分的过程依赖于对所有卷应用标签。它遵循一个命名空间命名约定,如下所示
ceph.<tag name>=<tag value>
所有标签都以 ceph 关键字为前缀,以声明该命名空间的所有权并使其易于识别。这是 OSD ID 在 zfs 标签上下文中的使用方式
ceph.osd_id=0
文件系统上的标签作为属性存储。zpool 上的标签作为以 ; 分隔的串联列表存储在注释属性中
元数据
以下描述了存储在 ZFS 文件系统、卷、池上的所有 Ceph OSD 元数据
type
描述设备是 OSD 还是 Journal,并能够在支持时扩展到其他类型
示例
ceph.type=osd
cluster_fsid
示例
ceph.cluster_fsid=7146B649-AE00-4157-9F5D-1DBFF1D52C26
data_device
示例
ceph.data_device=/dev/ceph/data-0
data_uuid
示例
ceph.data_uuid=B76418EB-0024-401C-8955-AE6919D45CC3
journal_device
示例
ceph.journal_device=/dev/ceph/journal-0
journal_uuid
示例
ceph.journal_uuid=2070E121-C544-4F40-9571-0B7F35C6CB2B
osd_fsid
示例
ceph.osd_fsid=88ab9018-f84b-4d62-90b4-ce7c076728ff
osd_id
示例
ceph.osd_id=1
block_device
仅用于 bluestore 后端。捕获逻辑卷路径的路径。
示例
ceph.block_device=/dev/gpt/block-0
block_uuid
仅用于 bluestore 后端。捕获逻辑卷 UUID 或分区 UUID。
示例
ceph.block_uuid=E5F041BB-AAD4-48A8-B3BF-31F7AFD7D73E
db_device
仅用于 bluestore 后端。捕获逻辑卷路径的路径。
示例
ceph.db_device=/dev/gpt/db-0
db_uuid
仅用于 bluestore 后端。捕获逻辑卷 UUID 或分区 UUID。
示例
ceph.db_uuid=F9D02CF1-31AB-4910-90A3-6A6302375525
wal_device
仅用于 bluestore 后端。捕获逻辑卷路径的路径。
示例
ceph.wal_device=/dev/gpt/wal-0
wal_uuid
仅用于 bluestore 后端。捕获逻辑卷 UUID 或分区 UUID。
示例
ceph.wal_uuid=A58D1C68-0D6E-4CB3-8E99-B261AD47CC39
compression
始终可以使用卷或文件系统上的本机 zfs 设置来设置启用压缩的设备。这将在创建卷或文件系统时激活。当通过 ceph-volume zfs 激活时,将创建此标签。在 ceph-volume 之后手动设置的压缩将不会被注意到,除非也手动设置此标签。
已启用压缩设备的示例
ceph.vdo=1