-
Notifications
You must be signed in to change notification settings - Fork 0
maintain curve
- 查看集群列表
- 切换集群
- 添加集群
- 删除集群
- 导出集群
- 导入集群
- 查看集群拓扑
- 修改集群拓扑
- 对比集群拓扑
- 查看集群状态
- 启动服务
- 停止服务
- 重启服务
- 修改服务配置
- 进入服务容器
- 清理集群
- 查看客户端状态
- 进入客户端容器
- 获得 Curve 团队技术支持
$ curveadm cluster ls
若想显示集群详细信息,可添加 -v
选项,该选项将显示集群 ID
、集群 UUID
、集群创建时间
、集群描述
等相关信息:
$ curveadm cluster ls -v
切换指定集群为当前管理集群。切换集群后,之后的操作都将作用于该集群。
$ curveadm cluster checkout <cluster-name>
切换集群后,再次查看集群列表时,当前集群名前会出现 *
样图标,我们以此来确定当前操作集群。
用户可在添加集群的同时指定集群拓扑文件,亦可先添加集群,之后再通过修改集群拓扑的方式提交集群拓扑:
$ curveadm cluster add <cluster-name> [-f topology.yaml]
$ curveadm cluster rm <cluster-name>
⚠️ 警告:删除集群后,该集群相关信息将全部被清除,请谨慎操作。
curveadm
支持同时管理多个集群,在不必要的情况下,请勿删除集群。
我们可将当前集群信息保存为本地文件,通常我们在以下 2 种情况下需要导出集群:
- 需将集群信息做定时备份,以防丢失
- 与其他用户共享集群信息,以供其他用户操作集群
$ curveadm cluster export <cluster-name> [-o database-file-path]
💡 提示:
导出的集群文件以集群
UUID
为键,该UUID
全局唯一,值则主要保存了以下 2 类信息:
- 集群的服务配置,即集群拓扑
- 每个服务的相关信息,包括服务 ID、服务运行的容器 ID 等
$ curveadm cluster import <cluster-name> [-f database-file-path]
📢 注意:
- 导入集群时指定的集群名不可与已存在的集群名重复,否则将导致导入失败
- 导入集群时会将集群拓扑原封不动导入,所以可能会导致某些配置项失效,如 SSH 的私钥路径配置项
private_key_path
, 遇到此类情况,用户可修改集群拓扑并提交后即可正常操作集群
$ curveadm config show
💡 提醒:
当本地拓扑文件丢失时,我们可以通过保存当前的集群拓扑来恢复:
$ curveadm config show > topology.yaml
修改本地集群拓扑:
$ vim topology.yaml
当我们修改了本地的拓扑文件后,需向 CurveAdm 提交我们的修改,集群拓扑才能生效:
$ curveadm config commit <topology.yaml>
💡 提醒:
在提交本地集群拓扑时,终端会显示本地集群拓扑与当期集群拓扑之间的差异,请仔细对比,以防错误提交。
我们可通过以下命令来查看本地集群拓扑文件与当前集群拓扑之间的差异:
$ curveadm config diff <topology.yaml>
$ curveadm status
CurveAdm 默认会显示服务 ID、服务角色、主机名、已部署的复制服务数量、容器 ID、运行状态:
Get Service Status: [OK]
cluster name : my-cluster
cluster kind : curvebs
cluster mds addr : 10.0.1.1:6666,10.0.1.2:6666,10.0.1.3:6666
cluster mds leader: 10.0.1.1:6666 / 505da008b59c
Id Role Host Replicas Container Id Status
-- ---- ---- ------- ------------ ------
c9570c0d0252 etcd server-host1 1/1 ced84717bf4b Up 45 hours
493b7831907c etcd server-host2 1/1 907f8b84f527 Up 45 hours
8438cc5ecb52 etcd server-host3 1/1 44eca4798424 Up 45 hours
505da008b59c mds server-host1 1/1 37c05bbb39af Up 45 hours
e7bfb934182b mds server-host2 1/1 044b56281928 Up 45 hours
1b322781339c mds server-host3 1/1 b00481b9872d Up 45 hours
<replicas> chunkserver server-host1 3/3 <replicas> RUNNING
<replicas> chunkserver server-host2 3/3 <replicas> RUNNING
<replicas> chunkserver server-host3 3/3 <replicas> RUNNING
2912bbdbcb48 snapshotclone server-host1 1/1 8b7a14b872ff Up 45 hours
b862ef6720ed snapshotclone server-host2 1/1 8e2a4b9e16b4 Up 45 hours
ed4533e903d9 snapshotclone server-host3 1/1 a35c30e3143d Up 45 hours
- 若想查看其余信息,如监听端口、日志目录、数据目录等,可添加
-v
参数 - 对于同一台主机上的复制服务来说,其状态默认是折叠的,可添加
-s
参数来显示每一个副本服务
$ curveadm start
CurveAdm 默认启动集群中的所有服务,如需启动指定服务,可通过添加以下 3 个选项来实现:
-
--id
: 启动指定id
的服务 -
--host
: 启动指定主机的所有服务 -
--role
: 启动指定角色的所有服务
以上 3 个选项可任意组合使用,服务对应的 id
、host
、role
可通过 curveadm status 来查看。
$ curveadm start --id c9570c0d0252
$ curveadm start --host 10.0.1.1 --role mds
$ curveadm stop
CurveAdm 默认停止集群中的所有服务,如需停止指定服务,可通过添加以下 3 个选项来实现:
-
--id
: 停止指定id
的服务 -
--host
: 停止指定主机的所有服务 -
--role
: 停止指定角色的所有服务
以上 3 个选项可任意组合使用,服务对应的 id
、host
、role
可通过 curveadm status 来查看。
$ curveadm stop --id c9570c0d0252
$ curveadm stop --host 10.0.1.1 --role mds
⚠️ 警告:停止服务可能造成集群不健康,导致客户端 IO 失败,请谨慎操作。
$ curveadm restart
CurveAdm 默认重启集群中的所有服务,如需重启指定服务,可通过添加以下 3 个选项来实现:
-
--id
: 重启指定id
的服务 -
--host
: 重启指定主机的所有服务 -
--role
: 重启指定角色的所有服务
以上 3 个选项可任意组合使用,服务对应的 id
、host
、role
可通过 curveadm status 来查看。
$ curveadm restart --id c9570c0d0252
$ curveadm restart --host 10.0.1.1 --role mds
在集群运行的过程中,我们可能需要修改服务的配置,并重启服务。具体操作步骤如下:
$ vim topology.yaml
💡 提醒:
当本地拓扑文件丢失时,我们可以通过保存当前的集群拓扑来恢复:
$ curveadm config show > topology.yaml
$ curveadm config commit topology.yaml
$ curveadm reload
CurveAdm 默认重新加载集群中的所有服务,如需重新加载指定服务,可通过添加以下 3 个选项来实现:
-
--id
: 重新加载指定id
的服务 -
--host
: 重新加载指定主机的所有服务 -
--role
: 重新加载指定角色的所有服务
以上 3 个选项可任意组合使用,服务对应的 id
、host
、role
可通过 curveadm status 来查看。
$ curveadm reload --id c9570c0d0252
$ curveadm reload --host 10.0.1.1 --role mds
💡 提醒:
命令 restart 与
reload
的区别在于,reload
会根据当前集群拓扑的变更修改相应服务的配置,然后再重启服务, 而restart
则只会简单的重启服务。
我们可以远程进入服务容器内,查看服务进程、配置、日志、数据等信息:
$ curveadm enter <id>
服务对应的 id
可通过 curveadm status 来查看。
💡 提醒:
CurveAdm 默认进入该服务的根目录,服务根目录包含了服务所需的所有文件,其目录结构如下:
/curvefs/mds # 服务根目录 |-- conf # 配置目录 | `-- mds.conf |-- data # 数据目录 |-- logs # 日志目录 | `-- curvefs-mds.log.INFO.20220120-142115.6 `-- sbin # 二进制目录 `-- curvefs-mds
$ curveadm clean
CurveAdm 默认清理集群中所有服务的所有对象,如需清理指定服务或对象,可通过添加以下 4 个选项来实现:
-
--id
: 清理指定id
所对应的服务 -
--host
: 清理指定主机所对应的服务 -
--role
: 清理指定角色所对应的服务 -
--only
: 清理指定对象 (log
: 日志,data
: 数据,container
: 容器)
以上 4 个选项可任意组合使用,服务对应的 id
、host
、role
可通过 curveadm status 来查看。
$ curveadm clean --id c9570c0d0252
$ curveadm clean --role mds --only log,data
$ curveadm clean --host 10.0.1.1 --role mds
📢 注意:
当清理服务容器时,请确保相应服务已停止,你可以使用 stop 命令来停止指定服务。
$ curveadm client status
CurveAdm 默认会显示客户端 ID、客户端类型、主机、容器 ID、运行状态、辅助信息:
Get Client Status: [OK]
Id Kind Host Container Id Status Aux Info
-- ---- ---- ------------ ------ --------
362d538778ad curvebs server-host1 cfa00fd01ae8 Up 36 hours {"user":"curve","volume":"/test1"}
b0d56cfaad14 curvebs server-host2 c0301eff2af0 Up 36 hours {"user":"curve","volume":"/test2"}
c700e1f6acab curvebs server-host3 52554173a54f Up 36 hours {"user":"curve","volume":"/test3"}
我们可以远程进入服务容器内,查看客户端进程、配置、日志、数据等信息:
$ curveadm client <id>
客户端对应的 id
可通过 curveadm client status 来查看。
💡 提醒:
CurveAdm 默认进入该客户端的根目录,客户端根目录包含了服务所需的所有文件,其目录结构如下:
/curvefs/client # 服务根目录 |-- conf # 配置目录 | `-- client.conf |-- data # 数据目录 |-- logs # 日志目录 | `-- curvefs-client.log.INFO.20220120-142115.6 `-- sbin # 二进制目录 `-- curve-fuse
当你的服务遇到异常,需要 Curve 团队的技术支持时,你可以通过 support
命令来将集群的一些必要信息,
如服务配置和日志进行打包压缩,并上传到 Curve 中心。
我们保证所有信息都将被加密,并只有你拥有秘钥:
$ curveadm support
你可以通过添加 --client
参数指定客户端 ID 来一并上报客户端日志,客户端 ID 可通过 curveadm client status 查看。
$ curveadm support --client 462d538778ad
💡 提醒:
当数据上传成功后,终端会显示相应的秘钥,请将该秘钥告诉 Curve 团队成员,以供他们分析及排查问题。
© 2022 Curve Team. All Rights Reserved