如何用Ansible Playbook递归替换目录下所有文件的指定路径字符串？

当使用Ansible Replace模块直接指定目录时出现/var/app/test is a directory错误，核心原因是未启用递归处理目录下文件的配置。以下是完整的解决方法：

完整Playbook示例 #

- name: 递归替换目标目录下所有文件的指定路径字符串
  hosts: all
  tasks:
    - name: 拼接新旧路径字符串
      set_fact:
        old_target_path: "{{ inst_path }}/{{ inst_name }}/abc/{{ oldver }}"
        new_target_path: "{{ inst_path }}/{{ inst_name }}/abc/{{ new_version }}"

    - name: 递归替换文件内容
      ansible.builtin.replace:
        path: "{{ inst_path }}/{{ inst_name }}"
        regexp: "{{ old_target_path | regex_escape }}"
        replace: "{{ new_target_path }}"
        recurse: yes
        # 可选：仅替换特定后缀的文件，比如只处理配置文件
        # files_matching: "*.conf"

关键说明 #

1. recurse: yes参数：这是解决目录报错的核心，启用后Replace模块会递归遍历目标目录下的所有文件，而非直接把目录当作文件处理。
2. regex_escape过滤器：自动转义路径中的斜杠、特殊字符，避免正则表达式语法错误，确保路径字符串能被正确匹配。
3. 变量拼接：通过set_fact把传入的参数拼接成完整的新旧路径，逻辑更清晰，也方便后续维护。

如何传递参数 #

如果不在Playbook中硬编码变量，可以通过命令行传入参数：

ansible-playbook your_playbook.yml -e "inst_path=/var/app inst_name=test oldver=80526 new_version=80528"

内容的提问来源于stack exchange，提问作者Sachin B M