Ansible读取YAML文件新增修改字段后写入另一文件的实现方法

核心逻辑不需要依赖第三方模块，用Ansible自带的过滤器和核心模块就能完成，全程不会修改原始源文件，支持文件名、字段值全部配置为变量。

方案1：字典合并方案（鲁棒性优先，推荐） #

这个方案会把YAML内容解析为字典操作，不依赖固定的行格式，不管源文件中country字段是否存在、在什么位置，都能正确设置值，缺点是重写后的文件不会保留原文件的注释。
完整playbook示例：

- name: 处理YAML文件字段
  hosts: localhost
  gather_facts: no
  vars:
    # 以下变量可直接替换为你大型playbook中已定义的对应变量
    src_yaml_path: "file1.yaml"
    dest_yaml_path: "file2.yaml"
    target_country_val: "lka" # 替换为你需要设置的country值
  tasks:
    - name: 检查源YAML文件是否存在
      ansible.builtin.stat:
        path: "{{ src_yaml_path }}"
      register: src_file_info

    - name: 加载源文件内容，文件不存在则初始化为空字典
      ansible.builtin.set_fact:
        final_yaml: "{{ lookup('ansible.builtin.file', src_yaml_path) | from_yaml if src_file_info.stat.exists else {} }}"

    - name: 新增/覆盖country字段
      ansible.builtin.set_fact:
        final_yaml: "{{ final_yaml | combine({'country': target_country_val}) }}"

    - name: 将最终内容写入目标YAML文件
      ansible.builtin.copy:
        content: "{{ final_yaml | to_nice_yaml(indent=2) }}"
        dest: "{{ dest_yaml_path }}"
        mode: '0644' # 可按需调整目标文件权限

逻辑说明 #

• 先通过stat模块判断源文件是否存在，避免直接读不存在的文件报错
• 源文件存在时，用file lookup读取控制端文件内容，再通过from_yaml过滤器直接转成Ansible可操作的字典；文件不存在则直接给空字典，后续逻辑完全统一
• 用combine过滤器合并字典，存在country键就覆盖原值，不存在就新增
• 最后通过to_nice_yaml过滤器把字典转回标准YAML格式，写入目标文件

提示：如果你的源文件存放在远程被管理节点而非Ansible控制端，将方案1中「加载源文件内容」的task替换为下面的写法即可：

- name: 读取远程主机上的源文件内容
  ansible.builtin.slurp:
    src: "{{ src_yaml_path }}"
  register: remote_file_content
  when: src_file_info.stat.exists

- name: 解析远程文件内容
  ansible.builtin.set_fact:
    final_yaml: "{{ remote_file_content.content | b64decode | from_yaml if src_file_info.stat.exists else {} }}"

方案2：行级修改方案（保留原格式/注释） #

如果你需要完整保留源文件的注释、原始缩进和键顺序，可以用行匹配修改的方案，缺点是如果源文件YAML格式不规范（比如country前有多余空格、被注释）可能匹配失败：

- name: 处理YAML文件字段（保留原格式）
  hosts: localhost
  gather_facts: no
  vars:
    src_yaml_path: "file1.yaml"
    dest_yaml_path: "file2.yaml"
    target_country_val: "lka"
  tasks:
    - name: 检查源YAML文件是否存在
      ansible.builtin.stat:
        path: "{{ src_yaml_path }}"
      register: src_file_info

    - name: 源文件存在时先复制到目标路径
      ansible.builtin.copy:
        src: "{{ src_yaml_path }}"
        dest: "{{ dest_yaml_path }}"
        remote_src: no
        mode: '0644'
      when: src_file_info.stat.exists

    - name: 目标文件中新增/修改country行
      ansible.builtin.lineinfile:
        path: "{{ dest_yaml_path }}"
        regexp: '^country:'
        line: "country: {{ target_country_val }}"
        state: present
        create: yes # 文件不存在直接创建

注意：如果源文件在远程主机上，把copy模块的remote_src参数调整为yes即可，两种方案都适配远程执行场景。

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