注意
本文档适用于 Ceph 的开发版本。
ceph-conf -- ceph 配置文件工具
概要
描述
ceph-conf 是一个用于从 ceph 配置文件中获取信息的实用程序。与大多数 Ceph 程序一样，您可以使用 -c 标志指定要使用的 Ceph 配置文件。
请注意，与其他 ceph 工具不同，ceph-conf 只会从配置文件中读取（或返回编译在内的默认值）——它不会从监视器集群中获取配置值。因此，建议 ceph-conf 仅用于严格基于配置文件的传统环境。新的部署和工具应该转而依赖于显式查询监视器以获取配置（例如，ceph config get <守护进程> <选项>）或使用守护进程本身来获取有效的配置选项（例如，ceph-osd -i 123 --show-config-value osd_data）。后一种选项的优点是它可以从编译在内的默认值（偶尔在守护进程之间有所不同）、配置文件以及监视器的配置数据库中提取，从而提供该守护进程如果启动时将使用的确切值。
操作
ceph-conf 执行以下操作之一
- -L, --list-all-sections
列出配置文件中的所有部分。
- -l, --list-sections *prefix*
列出具有给定 prefix 的部分。例如，
--list-sections mon将列出所有以mon开头的部分。
- --lookup *key*
搜索并打印指定的配置设置。注意：
--lookup是默认操作。如果命令行上没有给出其他操作，我们将默认执行查找。
- -h, --help
打印使用摘要。
选项
- -c *conffile*
Ceph 配置文件。
- --filter-key *key*
过滤部分列表，使其仅包含定义了给定 key 的部分。
- --filter-key-value *key* ``=`` *value*
过滤部分列表，使其仅包含具有给定 key/value 对的部分。
- --name *type.id*
搜索部分时使用的 Ceph 名称（默认值 'client.admin'）。例如，如果我们指定
--name osd.0，将搜索以下部分：[osd.0]、[osd]、[global]
- --pid *pid*
覆盖展开选项时的
$pid。例如，如果一个选项配置为/var/log/$name.$pid.log，则其值中的$pid部分将使用 ceph-conf 的 PID 替换，而不是使用--name选项指定的进程的 PID。
- -r, --resolve-search
在结果的逗号分隔搜索列表中搜索第一个存在且可以打开的文件。
- -s, --section
要搜索的额外部分。这些额外部分将在通常搜索的部分之前搜索。一如既往，我们将返回找到的第一个匹配条目。
示例
要找出 osd 0 将对“osd data”选项使用什么值
ceph-conf -c foo.conf --name osd.0 --lookup "osd data"
要找出 mds a 将对“log file”选项使用什么值
ceph-conf -c foo.conf --name mds.a "log file"
要列出所有以“osd”开头的A部分
ceph-conf -c foo.conf -l osd
要列出所有部分
ceph-conf -c foo.conf -L
要打印“client.0”使用的“keyring”路径
ceph-conf --name client.0 -r -l keyring
文件
/etc/ceph/$cluster.conf, ~/.ceph/$cluster.conf, $cluster.conf
如果未指定，要使用的 Ceph 配置文件。
可用性
ceph-conf 是 Ceph 的一部分，Ceph 是一个可大规模扩展的开源分布式存储系统。请参阅 Ceph 文档（网址为 https://docs.ceph.net.cn）以获取更多信息。
另请参阅
ceph(8),