Ansible主机特定文件优先，默认文件回退的实现方法

嘿，这个场景我太熟悉了！之前我在维护多主机的Ansible环境时也遇到过一模一样的需求——不想动原有角色代码，又要给特定主机用专属文件，找不到再回退通用版本。下面给你两个靠谱的解决方案，看你偏好哪种：

方案一：完全不修改原角色——调整搜索路径优先级 #

这个方法完美符合你的需求：不需要改动角色里的任何任务代码，仅通过配置变量调整文件搜索顺序，让主机特定目录优先被查找。

步骤1：创建主机特定文件目录 #

在你的Ansible项目根目录下，新建一个存放主机专属文件的目录，比如host_files/，然后在里面按主机名创建子目录：

your_project/
├── host_files/
│   └── target_hostname/  # 这里替换成你要特殊配置的主机名
│       └── index.html    # 该主机的专属默认页面
├── roles/
│   └── nginx/
│       ├── tasks/
│       │   └── main.yml  # 原角色任务，src: "index.html"
│       └── files/
│           └── index.html  # 通用版默认页面
└── host_vars/
    └── target_hostname.yml  # 目标主机的变量配置文件

步骤2：配置主机的搜索路径优先级 #

在host_vars/target_hostname.yml中添加ansible_search_path变量，把主机特定目录放在搜索列表的最前面：

# host_vars/target_hostname.yml
ansible_search_path:
  - "{{ playbook_dir }}/host_files/{{ inventory_hostname }}"
  - "{{ role_path }}/files"
  - "{{ role_path }}"
  - "{{ playbook_dir }}/files"
  - ./

这样当Ansible执行角色的copy任务时，会先去host_files/target_hostname/找index.html，如果找到就用这个专属版本；找不到的话，就会按后续路径回退到角色的通用版文件。

方案二：微调角色（更优雅）——用first_found查找插件 #

如果你能允许对角色做一点点微小的改动（只改一行代码），这个方法会更灵活直观，不需要额外维护搜索路径变量。

修改角色的copy任务 #

把原任务的src值改成用first_found lookup插件，指定优先查找主机特定文件，再回退通用文件：

- name: install nginx default page
  copy:
    src: "{{ lookup('first_found', [inventory_hostname ~ '/index.html', 'index.html']) }}"
    dest: /var/www/html/
    owner: root
    mode: 0644

存放主机特定文件 #

你可以把主机专属的index.html放在以下任意位置（遵循Ansible默认的文件搜索路径）：

• 角色的files/{{ inventory_hostname }}/index.html
• 项目根目录的files/{{ inventory_hostname }}/index.html
  Ansible会自动按你指定的顺序查找，找到第一个存在的文件就使用它。

这两种方法都能实现你要的效果，完全不用在编写角色时提前判断是否需要主机特定文件，后续要新增其他主机的专属文件也非常方便~

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