如何在Ansible中实现复杂YAML字典配置格式迁移？

我有一个用复杂字典配置的Ansible Role，旧配置格式存在不少弊端，于是重写了这个Role来简化配置。由于该Role已经被广泛使用，希望能兼容现有使用旧配置格式的inventory和playbook，计划在执行Role前把旧配置迁移为新格式（所有数据都能迁移，技术上可行）。

示例数据 #

• 注：内容无实际意义，仅展示格式结构差异
• 注2：此问题聚焦通用解决思路（用set_facts？模板？自定义Python脚本？），而非示例数据的具体迁移

旧配置格式 #

petshop_old:
  petshop_data:
    name: awesome_petshop
  employee_data:
    - name_of_employee: sara
      date_of_birth: 2000
    - name_of_employee: john
      date_of_birth: 1995
  task_data:
    - name: clean_dogs
      time: morning
      by: john
    - name: clean_cats
      time: evening
      by: john
    - name: feed_birds
      time: evening
      by: sara

新配置格式 #

petshop_new:
  name: awesome_petshop
  employees:
    - name: sara
      birth_year: 2000
      tasks:
        - name: feed_birds
          time: evening
    - name: john
      birth_year: 1995
      tasks:
        - name: clean_dogs
          time: morning
        - name: clean_cats
          time: evening

现有Role任务框架 #

tasks/main.yml：

- name: Migrate the old config data into the new format
  when: (petshop_old is defined) and (petshop_new is not defined)
  block:
    [...] Here come the migration tasks [...]

- name: This tasks prints the config, even when originally petshop_old was given to the role
  ansible.builtin.debug:
    var: petshop_new
[...] do more stuff with the data [...]

请问在执行Role的实际任务前，将旧配置迁移为新格式的最佳方案是什么？

针对这类配置迁移场景，按优先级推荐以下方案：

1. 优先使用set_facts结合Jinja2表达式 #

这是最轻量化且贴合Ansible原生生态的方案，无需额外依赖，所有逻辑都在Playbook内完成：

• 利用Jinja2的循环、字典操作语法，将旧格式字段映射到新结构中
• 通过ansible.builtin.set_fact模块把转换后的结构赋值给petshop_new变量
• 优势：无需额外脚本，调试和维护简单，完全兼容Ansible的变量作用域规则

示例思路（适配你的场景）：

- name: 初始化员工基础数据
  when: petshop_old is defined and petshop_new is not defined
  ansible.builtin.set_fact:
    petshop_new:
      name: "{{ petshop_old.petshop_data.name }}"
      employees: "{{ petshop_old.employee_data | map('combine', {'name': item.name_of_employee, 'birth_year': item.date_of_birth, 'tasks': []}) | map('omit', 'name_of_employee', 'date_of_birth') | list }}"

- name: 为员工分配对应任务
  when: petshop_old is defined and petshop_new is not defined
  ansible.builtin.set_fact:
    petshop_new: "{{ petshop_new | combine({'employees': updated_employees}, recursive=True) }}"
  vars:
    updated_employees: "{{ petshop_new.employees | map('combine', {'tasks': petshop_old.task_data | selectattr('by', 'equalto', item.name) | list | map('omit', 'by') | list}) | list }}"
  loop: "{{ petshop_new.employees }}"

2. 复杂场景使用自定义Filter插件 #

如果配置转换逻辑非常复杂（多层嵌套、大量条件判断），可以编写Ansible自定义Filter插件：

• 用Python编写转换逻辑，封装成Filter，在Playbook中直接调用
• 优势：代码结构更清晰，可复用性强，适合处理复杂的映射规则
• 步骤：在Role的filter_plugins目录下创建Python脚本，实现转换函数，然后在set_fact中通过{{ petshop_old | old_to_new_format }}调用

3. 不推荐的方案 #

• 模板文件：模板适合生成静态文件，用来处理变量转换会增加不必要的文件IO，且调试不便
• 独立Python脚本：需要额外处理Ansible变量的传递和返回，容易出现作用域问题，维护成本高，破坏Playbook的原生可读性

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