Skip to content

[Priority: Med] [Ops] 补齐 deploy 自动化契约:非交互预检、健康验收与参数校验 #148

@liujuanjuan1984

Description

@liujuanjuan1984

背景

当前 deploy 流程可用,但在 agent 非交互调用场景下,成功语义与失败语义尚不够标准化,影响自动化编排稳定性。

归类缺口(来源于 #145 审查)

  • 缺口 A:deploy 缺少与 uninstall 对齐的非交互 sudo 预检(如 sudo -n 语义)。
  • 缺口 B:启动后缺少健康探测 + 超时 + 机器可读状态返回契约。
  • 缺口 C:provider/model 与 secret 的前置校验仍有空档(当前为 partial validation)。
  • 缺口 D:配置写入阶段缺少对 EnvironmentFile 注入风险(如换行污染)的统一防护策略。

目标

  • 将 deploy 脚本从“可执行”提升为“可编排”:非交互稳定、失败可判定、结果可机读。

范围

  1. 非交互执行预检规范。
  2. 部署完成判定规范(readiness + timeout + exit code contract)。
  3. 参数/密钥前置校验规范(provider/model/secret 组合)。
  4. EnvironmentFile 安全写入规范。

非目标

  • 当前不引入新的控制面服务。
  • 当前不替换 systemd 主路径。

验收标准(需求/方案阶段)

  • 形成 deploy 输入校验与返回码规范文档。
  • 形成健康检查判定与失败分类(可供 agent 重试/熔断)。
  • 形成 EnvironmentFile 安全写入与敏感值处理规范。

关联

参考快照

Metadata

Metadata

Assignees

No one assigned

    Labels

    status:todoPlanned but not started

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions