如何编写Ansible任务对模板生成的YAML文件执行YAML校验？

方法一：使用专用YAML校验工具yamllint #

这是最常用的方案，yamllint能检查YAML语法规范和格式问题。

1. 先在目标主机安装yamllint（以Debian/Ubuntu为例）

- name: 安装yamllint用于YAML校验
  ansible.builtin.apt:
    name: yamllint
    state: present
    update_cache: true
  become: true

如果是跨系统通用的pip安装方式：

- name: 通过pip安装yamllint
  ansible.builtin.pip:
    name: yamllint
    state: present
  become: true

2. 执行YAML校验任务

- name: 校验生成的YAML配置文件
  ansible.builtin.command: yamllint "{{ install_path_config }}/{{ item }}"
  register: yamllint_result
  failed_when: yamllint_result.rc != 0
  with_ansible.builtin.items: "{{ config_files }}"

• register 用于捕获命令执行结果
• failed_when 设置当返回码不为0时任务失败，即YAML文件存在语法问题时终止流程

方法二：用Python内置YAML模块校验（无需额外工具） #

利用Ansible依赖的Python pyyaml 模块，直接解析文件判断合法性：

- name: 用Python校验YAML文件语法
  ansible.builtin.command: python3 -c "import yaml; yaml.safe_load(open('{{ install_path_config }}/{{ item }}'))"
  register: yaml_check_result
  failed_when: yaml_check_result.rc != 0
  with_ansible.builtin.items: "{{ config_files }}"

这个方法无需额外安装工具，只要目标主机有Python3和pyyaml（Ansible通常已自带），适合不想额外部署工具的场景。

注意事项 #

• 如果你的config_files变量里已经包含.yml后缀，直接用{{ item }}即可；如果原来的config_files不带后缀（比如模板是foo.yml.j2，item是foo.yml），则无需修改路径。
• 可根据需求调整失败策略，比如把failed_when改成warn，仅告警不终止任务，或者将结果输出到指定日志。

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