复用 Pigsty 已经拥有的 CMDB
决策日期： 2026-07-18
状态： 适配器随 v1.6.0 发布，仍为实验功能；早期版本存储设计已被取代。
当前参考：pig inventory cmdb
范围： 与 Pigsty 既有 CMDB 交换声明，而不是再设计一个配置数据库。
决策
PIG 必须复用 Pigsty 已经提供的 CMDB。它的职责是有边界的适配：校验静态 Inventory， 将声明装载到既有表中，导出既有投影，检查一致性，并安全切换 Ansible 的静态与动态数据源。
PIG 不拥有第二套 schema、迁移历史、快照账本、CAS revision store、三方合并引擎或数据库回滚系统。
背景
早期设计把 CMDB 支持当成一个全新后端，提出独立 schema、不可变快照、revision token、合并与回滚、
备份 bundle 和数据源切换记录。方案内部逻辑完整，但出发点错误：Pigsty 已经拥有 pigsty 与 pglog
schema、装载脚本、动态 Inventory 投影和数据源切换行为。
再建一套控制面会复制事实、制造同步问题，并让 PIG 对另一个项目拥有的数据模型负责。
考虑过的方案
- 把新 revision store 保留为高级模式。 即使可选，两套权威仍然是两套权威。
- 在新旧 schema 之间双向镜像。 冲突处理与迁移会成为永久产品责任。
- 只用 Shell 包装既有脚本。 PIG 仍需要有边界的超时、安全连接处理、结构化计划与原子数据源切换。
- 完全删除 CMDB 支持。 一个小型原生适配器仍能提供有价值的校验与自动化，而不重新定义 schema。
契约
- Pigsty 既有 schema 与投影是数据模型权威；
- PIG 通过显式数据库目标、环境配置或
service=meta连接； - 凭据、DSN、SQL 正文与声明值不得进入计划或诊断；
check只读；init用匹配版本的基线替换pigsty与pglogschema，并要求确认；操作前先备份现有数据库；load在事务内替换声明行，并要求显式确认；dump在没有 force 时拒绝意外覆盖；enable与disable只修改能够识别的 Ansible Inventory source 形式，并原子写入；- 无法识别的可执行 Inventory source 一律拒绝，不擅自重写；
- 整个命令族继续明确标记为实验功能。
影响
修订移除了重复的版本存储实现，也减少了维护工作。
保留下来的适配器更小、更容易审计，也与现有 Pigsty 运维方式兼容。
它同时继承既有系统的限制：init 需要运维人员自行备份，装载声明属于替换操作，而不是协同版本控制。
验证与演进
纠正后的边界记录在 ba6e678。
废弃实现由 e0f73ed 删除，
其中包括平行 schema、snapshot、merge、revision 与 rollback 机制。
保留路径的测试覆盖 PostgreSQL 兼容性、连接信息脱敏、事务失败、摘要绑定确认、dump 安全和原子数据源切换。
当前状态
既有 CMDB 适配器已随 v1.6.0 发布，但仍为实验功能。
初始化或替换前先备份 CMDB。操作流程见 pig inventory 文档。