Ansible变量文件递归循环错误解决：保持DRY原则的方案

这个递归循环错误的根源在于：当你传入app_name=app1时，{{apps[app_name].some_var}}会被解析为apps.app1.some_var，而这个变量和它所在的apps.app1.greeting属于同一个父级变量结构apps.app1。Ansible的变量解析器会把这种引用判定为递归依赖，从而抛出错误。

下面是两种既能保持DRY（Don't Repeat Yourself）原则，又能解决循环问题的方案：

方案1：提取通用模板到独立变量 #

把重复的greeting模板抽离成单独的变量，让每个app的greeting引用这个模板并传入自身的some_var值，这样就能避免在同一个app的变量结构内引用自身：

修改后的vars/apps.yml：

# 通用模板，独立于具体app
greeting_templates:
  dev: "{{ some_val }} world!"
  prod: "{{ some_val }} planet {{ planet }}!"

apps:
  app1:
    some_var: hello
    planet: earth
    greeting:
      dev: "{{ greeting_templates.dev | vars(some_val=apps.app1.some_var) }}"
      prod: "{{ greeting_templates.prod | vars(some_val=apps.app1.some_var, planet=apps.app1.planet) }}"
  app2:
    some_var: hi
    planet: mars
    greeting:
      dev: "{{ greeting_templates.dev | vars(some_val=apps.app2.some_var) }}"
      prod: "{{ greeting_templates.prod | vars(some_val=apps.app2.some_var, planet=apps.app2.planet) }}"

这里用到的vars过滤器（Ansible 2.10+支持）可以直接给模板变量传值，既简洁又能完全复用模板逻辑，每个app只需要维护自身的个性化参数，完美符合DRY原则，同时彻底打破了递归引用链。

如果你的Ansible版本较低，也可以用字符串替换的方式实现：

greeting_templates:
  dev: "__SOME_VAL__ world!"
  prod: "__SOME_VAL__ planet __PLANET__!"

apps:
  app1:
    some_var: hello
    planet: earth
    greeting:
      dev: "{{ greeting_templates.dev | replace('__SOME_VAL__', apps.app1.some_var) }}"
      prod: "{{ greeting_templates.prod | replace('__SOME_VAL__', apps.app1.some_var) | replace('__PLANET__', apps.app1.planet) }}"
  app2:
    some_var: hi
    planet: mars
    greeting:
      dev: "{{ greeting_templates.dev | replace('__SOME_VAL__', apps.app2.some_var) }}"
      prod: "{{ greeting_templates.prod | replace('__SOME_VAL__', apps.app2.some_var) | replace('__PLANET__', apps.app2.planet) }}"

方案2：在Playbook中动态生成greeting #

如果不想修改变量文件的原始结构，可以把greeting的组装逻辑移到Playbook中，变量文件只保留基础数据：

变量文件vars/apps.yml保持极简结构： #

apps:
  app1:
    some_var: hello
    planet: earth
  app2:
    some_var: hi
    planet: mars

# 通用模板
greeting_templates:
  dev: "{{ some_val }} world!"
  prod: "{{ some_val }} planet {{ planet }}!"

Playbook中处理逻辑： #

- name: Generate and use app greeting
  hosts: localhost
  vars_files:
    - vars/apps.yml
  vars:
    app_name: app1  # 也可以通过命令行`--extra-vars "app_name=app1"`传入
  tasks:
    - name: Dynamically set greeting for target app
      set_fact:
        target_app_greeting:
          dev: "{{ greeting_templates.dev | vars(some_val=apps[app_name].some_var) }}"
          prod: "{{ greeting_templates.prod | vars(some_val=apps[app_name].some_var, planet=apps[app_name].planet) }}"
    
    - name: Verify the greeting
      debug:
        msg: "Dev greeting: {{ target_app_greeting.dev }} | Prod greeting: {{ target_app_greeting.prod }}"

这种方式把变量组装和数据存储分离，变量文件只负责保存原始信息，Playbook负责逻辑拼接，同样能避免递归问题，且保持了代码的复用性。

为什么原写法会触发循环？ #

Ansible的变量解析器会追踪变量的依赖关系，当apps.app1.greeting.dev引用apps[app_name].some_var（即apps.app1.some_var）时，它会认为apps.app1这个变量结构内部存在自引用——哪怕逻辑上只是引用同结构下的另一个字段，解析器也会判定为递归循环。通过将模板抽离到独立变量或在Playbook中动态生成，就能打破这个依赖链，解决错误。

内容的提问来源于stack exchange，提问作者Munchkin