跳到主要内容

存储管理

管理悦库的文件存储路径和系统数据路径。

子命令一览​

子命令需要登录只读说明
store node list—✓查看所有存储节点及其路径列表
store path add✓—为存储节点添加新文件存储路径
store path merge✓—将源路径数据迁移至目标路径并移除源路径
store sys-path set✓—将系统数据迁移至新路径

查看存储节点​

opscli store node list
opscli store node list --json

直接读取本机配置文件，无需登录。列出各存储节点的 ID、名称及包含的存储路径列表。

添加存储路径​

当某存储节点的磁盘空间不足时，可以添加新的存储路径（指向其他磁盘）。

opscli store path add --nodeID <节点ID> --path <新路径>
# 或使用节点名称
opscli store path add --nodeName <节点名称> --path <新路径>
参数必填说明
--nodeID✓*¹存储节点 ID（可通过 store node list 查看）
--nodeName✓*¹存储节点名称，与 --nodeID 二选一
--path✓新存储路径的绝对路径（须在本机已存在）
--yes—自动确认服务关闭等交互提示（供脚本/CI 使用）
--no-restart—跳过重启，手动重启后生效

*¹ --nodeID 与 --nodeName 必须且只能指定其一。

注意：执行前服务需已关闭。 若服务正在运行，命令会询问是否自动关闭：

检测到服务正在运行，是否自动关闭服务？输入 "yes" 继续，其他输入退出:

示例：

opscli store path add --nodeID 0 --path /data/oss/disk2

迁移存储路径​

存储路径不支持直接删除（删除会导致数据丢失）。若某路径所在磁盘即将满载，使用此命令将源路径的数据迁移至同节点的目标路径，成功后自动移除源路径配置。

opscli store path merge --from <源路径> --to <目标路径>
参数必填说明
--from✓迁出的源存储路径（绝对路径，须属于某存储节点）
--to✓迁入的目标存储路径（绝对路径，须与 --from 在同一节点）
--yes—自动确认交互提示
--no-restart—跳过重启，手动重启后生效

迁移原则：先复制 → 校验成功 → 再删除原始文件，任何步骤失败均立即退出，不影响源路径数据。

示例：

opscli store path merge --from /data/oss/disk1 --to /data/oss/disk2

迁移系统数据路径​

opscli store sys-path set --path <新路径>
参数必填说明
--path✓新系统数据路径的绝对路径（须已存在且可读写）
--yes—自动确认交互提示
--no-restart—跳过重启，手动重启后生效

将系统数据（MySQL、Redis 等数据库文件）迁移至新路径，迁移完成后删除原路径数据。

常见问题​

  • 提示"请先执行 opscli login"：先执行 opscli login（store node list 无需登录）。
  • 路径不存在：store path add 和 store sys-path set 要求目标路径在本机已创建。
  • store path merge 提示"不在同一存储节点"：--from 和 --to 必须属于同一存储节点，可通过 store node list 确认。
  • 操作后需要重启：除非指定 --no-restart，命令会在写入配置后自动重启受影响的服务节点。