主题
启停、日志与卸载
日常操作
bash
deploy middleware start redis --no-follow
deploy middleware stop redis --no-follow
deploy middleware restart redis --no-follow
deploy middleware logs redis --no-follow # 最近 100 行组件日志- 每个动作都是 Run:返回 runId,用
deploy logs <runId> -f跟随;--no-follow适合脚本。 - 多组件可一次传多个 key:
restart redis postgresql。 - 动作失败跟随日志以退出码 1 收尾;核对
middleware get的 running 状态。
状态核对
bash
deploy middleware list # 方式/已装/在跑/版本/位置
deploy middleware get redis # 状态 + 详情 + 可编辑参数installed 与 running 是两回事:容器存在但退出时 installed=true、running=false。 重启后务必 get 核对,而不是只看 restart 命令退出码 0。
卸载
bash
deploy middleware remove redis --yes --no-follow- 非交互环境必须
--yes;--force让「容器不存在」也算成功。 - 容器卸载保留数据卷:数据不丢,重装同组件可续用。
- native 卸载打印手动清理指引(包管理器 remove、目录清理),不自动执行。
- 删除数据卷是独立的破坏性操作,需要显式授权与单独执行(docker volume rm),不属于 remove 的隐含行为。
卸载前检查
- 哪些应用连着它:连接串、环境变量、Secret 中的 host/port。
- 数据是否需要导出(pg_dump / mysqldump / redis RDB 拷贝)。
- 是否被其他中间件依赖(如应用容器网络)。
- 卸载后读回
middleware list,并验证依赖应用的健康检查。
重建与升级
- 同版本重建:
install <key> --force(保留数据卷)。 - 换版本:
set -p PG_VERSION=17后install --force;大版本跨升级先备份数据卷,容器镜像升级不等于数据迁移。 - 升级失败回退:set 回旧版本再 force;数据卷已被新版本写过时可能无法回退——备份是唯一保险。