注意

本文档适用于 Ceph 开发版本。

Orchestrator CLI

该模块为 Orchestrator 模块提供命令行界面 (CLI)。ceph-mgr与外部

术语定义

Orchestrator CLI 统一了多个外部编排器,因此我们需要为 Orchestrator 模块

主机

物理主机的

服务类型

服务的类型。例如,nfs、mds、osd、mon、rgw、mgr、iscsi

服务

逻辑服务。通常由多个主机上的多个服务实例组成,以实现高可用性

  • fs_name对于 mds 类型

  • rgw_zone对于 rgw 类型

  • ganesha_cluster_id对于 nfs 类型

守护进程

服务的单个实例。通常是一个守护进程,但可能不是

此标识符应

下面是名称之间的关系:

  • A 服务具有特定的服务类型.

  • A 守护进程是特定服务类型的服务类型.

Note

Orchestrator 模块可能只实现下面列出的命令的一个子集。不同模块的命令实现可能不同。

状态

ceph orch status [--detail]

该命令显示当前的 Orchestrator 模式及其高级状态

无状态服务(MDS/RGW/NFS/rbd-mirror/iSCSI)

Note

Orchestrator 不会配置服务。有关如何配置特定服务的详细信息,请参阅相关文档。

The name参数标识实例组的类型。以下简短列表解释了name参数:

  • CephFS 文件系统标识一组 MDS 守护进程。

  • 区域名称标识一组 RGWs。

创建/扩展/缩小/删除服务:

ceph orch apply mds <fs_name> [--placement=<placement>] [--dry-run]
ceph orch apply rgw <name> [--realm=<realm>] [--zone=<zone>] [--port=<port>] [--ssl] [--placement=<placement>] [--dry-run]
ceph orch apply nfs <name> <pool> [--namespace=<namespace>] [--placement=<placement>] [--dry-run]
ceph orch rm <service_name> [--force]

其中placement。例如,要将新卷的MDS守护进程放置在标记为守护进程放置.

例如,ceph orch apply mds myfs --placement="3 host1 host2 host3"

服务命令:

ceph orch <start|stop|restart|redeploy|reconfig> <service_name>

Note

这些命令仅适用于 cephadm 容器化守护进程。

Options

start

在相应主机上启动守护进程。

stop

在相应主机上停止守护进程。

restart

在相应主机上重新启动守护进程。

redeploy

在相应主机上重新部署 Ceph 守护进程。这将重新创建/var/lib/ceph/<fsid>/<daemon-name>(如果不存在)下的守护进程目录结构

reconfig

在相应主机上重新配置守护进程。这将刷新配置文件,然后重新启动守护进程。

Note

此命令假定守护进程目录/var/lib/ceph/<fsid>/<daemon-name>已经存在。

配置 Orchestrator CLI

使用set backend命令选择将使用的 Orchestrator 模块:

ceph orch set backend <module>

示例 - 配置 Orchestrator CLI

例如,要启用 Rook Orchestrator 模块并使用它进行 CLI 操作:

ceph mgr module enable rook
ceph orch set backend rook

确认后端已正确配置:

ceph orch status

禁用 Orchestrator

要禁用 Orchestrator,请使用空字符串"":

ceph orch set backend ""
ceph mgr module disable rook

当前实现状态

这是 Orchestrator 当前实现状态的概述。

命令

Rook

Cephadm

apply iscsi

apply mds

apply mgr

apply mon

apply nfs

apply osd

apply rbd-mirror

apply cephfs-mirror

apply grafana

apply prometheus

apply alertmanager

apply node-exporter

apply rgw

apply container

apply snmp-gateway

host add

host ls

host rm

host maintenance enter

host maintenance exit

daemon status

daemon {stop,start,…}

device {ident,fault}-(on,off}

device ls

iscsi add

mds add

nfs add

rbd-mirror add

rgw add

ls

ps

status

upgrade

其中

  • ⚪ = 尚未实现

  • ❌ = 不适用

  • ✔ = 已实现

由 Ceph 基金会带给您

Ceph 文档是一个社区资源,由非盈利的 Ceph 基金会资助和托管Ceph Foundation. 如果您想支持这一点和我们的其他工作,请考虑加入现在加入.