Skip to content

安装与参数配置 ​

规程:先预演,后实装 ​

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 与日志访问权限;
  • 不要把安装日志贴进公开渠道。

延伸阅读 ​