Ansible角色中如何从外部目录加载变量文件？

问题原因 #

在Role任务中使用相对路径调用include_vars时，Ansible会默认将路径基准设置为Role的vars子目录，导致无法定位到Role外部的topologies目录。

解决方案 #

方法1：使用回溯路径定位项目根 #

从Role的tasks目录向上回溯两层（回到项目根目录，与roles、topologies同级），再指向目标变量目录：

# roles/apply_configuration/tasks/main.yml
- name: 加载拓扑变量文件
  include_vars:
    dir: ../../topologies/topo1/device1/config_vars

这种方式依赖固定的目录结构，若后续项目目录层级变化，需要同步调整路径。

方法2：使用Ansible内置变量playbook_dir（推荐） #

playbook_dir是Ansible自动生成的内置变量，指向当前运行的Playbook所在的项目根目录，用它构建路径更稳定：

# roles/apply_configuration/tasks/main.yml
- name: 加载拓扑变量文件
  include_vars:
    dir: "{{ playbook_dir }}/topologies/topo1/device1/config_vars"

无论Role在项目中的位置如何变化，只要Playbook位于项目根，这个路径就始终有效。

方法3：动态传递变量路径（适合多拓扑场景） #

如果需要为不同设备加载不同的拓扑变量，可以在调用Role时传递变量路径：

1. 在Playbook中指定变量：

# 项目根目录下的Playbook文件
- hosts: device1
  roles:
    - role: apply_configuration
      vars:
        target_vars_dir: "{{ playbook_dir }}/topologies/topo1/device1/config_vars"

2. 在Role任务中使用该变量：

# roles/apply_configuration/tasks/main.yml
- name: 加载拓扑变量文件
  include_vars:
    dir: "{{ target_vars_dir }}"

这种方式灵活性最高，适合需要批量处理多拓扑、多设备的场景。

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