Ansible无法定位角色/templates目录下模板文件的问题求助

这是个很常见的Ansible角色模板查找问题，我来帮你一步步排查解决：

1. 先确认角色目录结构是否符合Ansible标准 #

Ansible对角色的目录层级有严格的约定，你的api角色必须是这种标准结构才能被正确识别：

/home/username/project/roles/
└── api/
    ├── tasks/
    │   └── deploy.yml
    ├── templates/
    │   └── supervisor/
    │       └── gunicorn.j2
    └── # 其他可选目录（如handlers、vars等）

重点检查：

• templates目录的拼写（别写成template少了s）
• 目录层级是否正确（不能把templates放在tasks文件夹下面）
• 大小写是否正确（Linux系统区分大小写，Templates和templates是两个不同目录）

2. 检查任务文件中引用模板的写法 #

在roles/api/tasks/deploy.yml里，你必须用相对角色的路径来引用模板，绝对路径或者相对Playbook的路径都会导致查找失败。正确写法示例：

- name: 部署gunicorn的supervisor配置
  template:
    src: supervisor/gunicorn.j2
    dest: /etc/supervisor/conf.d/gunicorn.conf

这里的src是相对于roles/api/templates/的路径，Ansible会自动去角色的templates目录下匹配，不需要额外写全路径。

3. 确认Ansible的角色搜索路径 #

当你执行Playbook时，Ansible会按优先级在几个位置查找角色：

• Playbook所在目录下的roles/文件夹（你的场景下应该是默认生效的，但前提是你要在正确的目录执行命令）
• 系统默认路径/etc/ansible/roles/
• 环境变量ANSIBLE_ROLES_PATH指定的路径

如果你的执行命令是在/home/目录下（而非/home/username/project/），Ansible会错误地在/home/roles/下找角色。解决方法：

• 切换到Playbook所在目录再执行：

  cd /home/username/project/
  ansible-playbook deploybook.yml
  

• 或者执行时手动指定角色路径：

  ansible-playbook /home/username/project/deploybook.yml --roles-path=/home/username/project/roles/
  

4. 排查拼写和权限问题 #

• 仔细核对模板文件的路径拼写，比如是不是把supervisor写成superviser，或者gunicorn.j2写成gunicon.j2了？
• 检查Ansible执行用户是否有读取模板文件的权限：

  ls -l /home/username/project/roles/api/templates/supervisor/gunicorn.j2
  

  如果文件是root创建的，而你用普通用户执行Ansible，可能会因为权限不足无法读取，需要调整文件权限或者用sudo执行Playbook。

5. 用debug模块验证查找路径 #

如果以上步骤都没问题，你可以在deploy.yml里加一个debug任务，看看Ansible实际在哪些路径搜索模板：

- name: 查看Ansible模板搜索路径
  debug:
    var: lookup('config', 'DEFAULT_TEMPLATE_PATH')

执行后会输出Ansible的默认模板路径列表，你可以对比是否包含你的角色templates目录，进一步定位问题。

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