主题
安装与参数配置
规程:先预演,后实装
bash
deploy middleware get redis --json # 现状:installed/running/模式/参数
deploy middleware fields redis # 可编辑参数表
deploy middleware install redis --dry-run --no-follow --json
deploy logs <runId> -f --json # 读完整预演计划与终态dry-run 产生运行记录与日志但不安装,任何平台可用。读计划时确认:暴露端口、挂载卷、模式、密码生成方式是否在授权范围内。 默认配置可能暴露无认证服务——预演不是走过场。
参数配置
bash
deploy middleware set redis -p REDIS_PORT=16380
deploy middleware set redis -p REDIS_PASSWORD=<强密码>
deploy middleware set postgresql -p PG_VERSION=17 --mode native
deploy middleware set redis -p REDIS_PASSWORD= # 空串 = 清空,回到随机生成set只改传入的键,其余保持。- 密码类值加密存储、不可读回;
fields/get不回显明文。 - 参数名即安装脚本读取的环境变量名(
REDIS_PORT、PG_VERSION、MYSQL_ROOT_PASSWORD等,以fields输出为准)。 - 已安装组件改参数后需
--force重建或 restart 才生效(视组件脚本语义,预演确认)。
实装
bash
deploy middleware install redis --no-follow --json # 返回 runId
deploy logs <runId> -f --json # 跟随到终态
deploy middleware get redis --json # 核对 installed/running/端口/模式- 不加
--no-follow默认跟随(middleware 命令用--follow,不是-f;logs才用-f)。 - 多组件按依赖序:
install docker redis postgresql;或install --missing只装缺失。 - 已安装默认跳过(
nothingToDo: true);--force才重建,重建保留数据卷。 - 指定模式:
-m native/-m docker(组件限制见 组件与安装模式)。
安装失败排查
| 现象 | 检查 |
|---|---|
| 端口冲突警告后容器启动失败 | 宿主机已占端口:ss -lntup;改 *_PORT 或停旧服务 |
| 镜像拉取暂停约 60s 后回退本地镜像 | 回退警告本身不是失败;无本地镜像时查 Docker 连通性与代理 |
| 容器起来又退 | middleware logs <key> 看组件日志;目录权限、内存(ES) |
| 报 middleware 端点不存在 | 服务端版本过旧,需升级 |
| 非 Linux 实装被拒 | 仅能 dry-run;换 Linux 服务端 |
密码与日志
安装时生成的随机密码可能在安装日志中显示一次(便于首次连接)。此后:
- 用
set -p *_PASSWORD=改为自管强密码并重建/重启; - 限制 dataDir 与日志访问权限;
- 不要把安装日志贴进公开渠道。