配置编排中的幂等保障是什么
幂等指同一份配置动作执行一次与执行多次的结果一致。在编排里它是重试、重入、补跑的前提：一次网络抖动导致任务被重放时，幂等步骤只是把状态再收敛一次，非幂等步骤则会追加重复条目、覆盖人工维护的内容、把计数翻倍。保障手段主要有四类：用「声明期望状态 + 工具比对差异」代替「执行命令」；给追加式操作加存在性判断；用唯一标识去重；把无法幂等的动作（发通知、开工单、触发外部流程）单独隔离并记录执行痕迹。
基本信息
| 目标 | 同一输入多次执行，结果与变更集一致 |
|---|---|
| 自检方法 | 连续执行两次，第二次变更数应为零 |
| 常见非幂等源 | 追加写配置、重复安装、自增编号、随机凭据 |
| 保障手段 | 期望状态声明、存在性判断、唯一标识、执行记录 |
| 副作用隔离 | 外部调用单独放置，可跳过可重放 |
典型使用场景
- 任务超时被判定失败后自动重试，重试不应产生额外变更
- 同一模板被多个环境重复下发，结果必须收敛一致
- 排查中误重启流程后重新执行，不应破坏已生效配置
- 补跑：只对未达标目标重跑而不影响已通过的目标
- 从失败批次重新进入编排，已完成的步骤不重复施加副作用
期望状态式写法示意
期望状态式写法示意
# 工具自己比对差异，内容一致时不落盘、不重启
- 文件: 确保目标文件内容与模板一致
- 用户: 确保账号存在且登录 shell 符合基线
- 服务: 确保服务运行且开机自启
# 必须用命令实现时，先判断再执行，例如内核参数：
# grep -q '^net.ipv4.ip_forward=1' /etc/sysctl.conf || echo '...' >> /etc/sysctl.conf
# 先判断后写入，重跑即无变更动作类型与幂等处理
| 动作类型 | 幂等性 | 处理方式 |
|---|---|---|
| 声明期望状态 | 天然幂等 | 首选，交由工具比对差异 |
| 创建资源 | 条件幂等 | 加存在性判断，已存在则只校正属性 |
| 追加写入 | 通常非幂等 | 先删后写、标记块替换或先判断 |
| 外部调用 | 非幂等 | 记录已执行标记，重入时跳过 |
自检方法很直接：对同一目标连续执行两次，第二次不应产生任何变更。若第二次仍有改动，说明存在隐藏的非幂等步骤，应定位到具体模块而不是整体接受。
用「删除整段再重写」实现幂等要谨慎：目标文件里若还有人工维护的内容会被一并覆盖。更稳的做法是把托管内容放进独立文件，或用明确的标记块界定托管区间。