Ansible中公共与特定环境变量的合并配置问题

在Ansible中，当你在group_vars/all定义嵌套字典形式的公共配置，再在group_vars/production中定义同名字典仅修改部分字段时，默认情况下Ansible会用子级字典完全替换父级字典，而非合并字段。这就导致任务中调用software.auto.gpg_key这类公共配置时，因为production的software字典覆盖了all中的内容，丢失了未定义的子字段，出现变量不存在的问题。

方法1：修改Ansible全局配置启用字典合并 #

在ansible.cfg中添加或修改以下配置，让Ansible对字典变量执行递归合并而非替换：

[defaults]
hash_behaviour = merge

• 效果：所有嵌套字典变量会自动合并，子级字典中定义的字段会覆盖父级，未定义的字段保留父级值。比如你在group_vars/production中只设置software.auto.enabled: true，software.auto.gpg_key等其他字段会保留group_vars/all中的值。
• 注意：这个配置是全局生效的，如果你有依赖字典替换逻辑的旧剧本，需要评估影响。

方法2：手动使用combine过滤器合并变量 #

如果不想修改全局配置，可以手动合并不同层级的变量：

1. 重命名公共变量文件中的字典，比如把group_vars/all中的software改为software_base
2. 在特定环境变量文件（如group_vars/production）中保留software作为环境专属配置
3. 在剧本开头用set_fact合并两个字典：

- name: 合并公共与环境专属配置
  set_fact:
    software: "{{ software_base | combine(software, recursive=True) }}"

这样software变量会包含software_base的所有字段，并被software中的字段覆盖。

方法3：使用include_vars的merge参数（Ansible 2.10+） #

在剧本中按顺序加载公共变量和环境变量，使用merge: yes参数实现合并：

- name: 加载公共配置
  include_vars:
    file: group_vars/all.yml
    name: software_base

- name: 加载环境专属配置并合并
  include_vars:
    file: group_vars/production.yml
    name: software
    merge: yes
    hash_behaviour: merge

最佳实践：结合角色与默认变量 #

对于大量环境和配置的场景，推荐使用Ansible角色来拆分逻辑：

1. 为每个软件模块（如prerequisites、docker）创建独立角色
2. 在角色的defaults/main.yml中定义该模块的完整默认配置（对应你group_vars/all中的公共配置）
3. 在group_vars的环境文件中，仅覆盖需要修改的字段（如software.docker.install.automatic.enabled: true）

• 优势：角色的默认变量优先级低于group_vars，且默认变量中的未覆盖字段会自动保留，无需额外合并操作，同时配置结构更清晰，便于维护。

内容的提问来源于stack exchange，提问作者Mr.Mister.