模板化与差异管理
模板化指把配置的公共骨架提取成模板，把随环境变化的部分抽成变量，再由变量取值渲染出各主机最终的配置文件。差异管理是它配套的纪律：环境差异（生产与测试、不同机房）属于允许差异，通过分组变量表达；单机个性差异应尽量收敛；为了应急手工改出来的差异必须回到模板，否则下次收敛会把它抹掉。判断标准很简单——差异声明在数据里可审查，还是隐藏在被复制过的模板副本里。
基本信息
| 适用平台 | Ansible Jinja2 模板、Puppet ERB/EPP、Chef 模板、Salt 状态与 Pillar |
|---|---|
| 表达手段 | 全局默认值、分组变量、单机变量、条件渲染、片段包含 |
| 差异层级 | 环境差异（允许）、分组差异（受限）、单机差异（谨慎）、手工热修（禁止） |
| 关键约束 | 变量要有默认值，模板渲染失败会整批中断 |
典型使用场景
- 同角色主机批量下发：数十台 Web 节点共用一份模板，仅连接数与磁盘路径不同
- 多环境发布：生产与预发的差异集中在变量文件，模板本身保持一致
- 与基线结合：模板渲染结果用于与基线做逐项比对
- 差异审查：发布前对比不同分组的渲染结果，确认差异符合预期
- 降低分叉：把「复制一份再改」的模板合并回单份加条件分支
- 快速新增节点：新机器只需进组，无需手工改配置
目录约定与条件渲染
目录约定与条件渲染
# 骨架只有一份，差异放在数据层
templates/app.conf.j2 # 模板骨架，含条件渲染
inventory/prod/hosts.ini # 生产清单，按分组划分
group_vars/all.yml # 全局默认值（必填，用于兜底）
group_vars/web.yml # Web 组差异
group_vars/db.yml # 数据库组差异
host_vars/db-01.yml # 单机差异，能用分组表达就别写这里
# 模板内用条件渲染替代复制分叉
[server]
max_connections = {{ app_max_conn | default(200) }}
{% if app_role == 'db' %}
shared_buffers = {{ db_shared_buffers }}
{% endif %}
# 渲染结果落盘留档，便于与基线比对
# 命令示例：ansible web -m template -a 'src=app.conf.j2 dest=/etc/app/app.conf' --check --diff差异类型与处理方式
| 差异类型 | 表达方式 | 允许度 | 处理要求 |
|---|---|---|---|
| 环境差异 | 分组变量文件 | 允许 | 纳入审查，写清理由 |
| 规格差异 | 按事实推导的参数 | 允许 | 给出取值范围与上限 |
| 单机差异 | 单机变量文件 | 谨慎 | 定期清理，能合并就合并 |
| 手工热修 | 直接改生产文件 | 禁止 | 发现后立刻回写模板 |
渲染前的 dry-run 与差异预览是差异管理的核心动作：先看会改哪几行、改前改后各是什么，再决定是否应用。多数配置管理工具都提供 check 与 diff 类选项，具体参数以各自官方文档为准。
手工改过的生产文件在下一次收敛时会被模板覆盖。排障时若发现有「改完过一会儿自己变回去」的现象，先查配置管理是否按周期收敛，再查模板里该项的取值来源。