Ansible忽略Python虚拟环境配置，默认使用/usr/bin/python问题排查

通过Semaphore运行Ansible Playbook（Ansible核心2.17.5，配置文件为/etc/ansible/ansible.cfg）时，遇到如下问题：

• 已在Playbook变量中指定Python虚拟环境路径，也修改了ansible.cfg里的interpreter_python配置
• 执行ansible-config dump --only-changed确认配置已生效，但Play依然默认用/usr/bin/python执行，虚拟环境配置完全被忽略

相关代码与配置 #

Playbook片段 #

- name: 示例Play
  hosts: target_hosts
  vars:
    ansible_python_interpreter: "/path/to/venv/bin/python"
  tasks:
    - name: 检查Python解释器路径
      command: which python
      register: python_path
    - name: 输出路径
      debug:
        var: python_path.stdout

ansible.cfg修改部分 #

[defaults]
interpreter_python = /path/to/venv/bin/python

调试输出片段 #

ansible [core 2.17.5]
  config file = /etc/ansible/ansible.cfg
  configured module search path = ['/home/user/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3.10/site-packages/ansible
  ansible collection location = /home/user/.ansible/collections:/usr/share/ansible/collections
  executable location = /usr/bin/ansible
  python version = 3.10.12 (main, Jun 11 2023, 05:26:28) [GCC 11.4.0]
  jinja version = 3.1.2
  libyaml = True

解决方法尝试 #

1. 检查Semaphore的环境变量/模板覆盖 #

Semaphore运行时可能通过自身配置覆盖Ansible变量：

• 进入Semaphore项目设置的环境变量板块，确认没设置ANSIBLE_PYTHON_INTERPRETER
• 查看任务模板的"Extra Arguments"，有没有加--extra-vars之类的参数覆盖了变量

2. 把解释器设为主机变量 #

在Inventory里直接给目标主机绑定解释器，优先级比Playbook变量和全局配置更高：

# inventory文件示例
target_hosts ansible_python_interpreter=/path/to/venv/bin/python

如果用动态Inventory，就在主机对应的vars里设置这个参数。

3. 验证目标主机的虚拟环境 #

先确认目标主机上的虚拟环境路径有效：

• 在目标主机上跑ls -l /path/to/venv/bin/python，检查路径存在且是可执行文件
• 确保Ansible执行用户（也就是Semaphore运行的用户）对这个路径有执行权限

4. 适配Ansible 2.17+的解释器逻辑 #

Ansible 2.17+对解释器选择做了调整，试试这种写法：

# ansible.cfg里修改
interpreter_python = auto_silent:/path/to/venv/bin/python

或者用vars_files加载变量，确保变量优先级正确。

5. 确认Semaphore加载了正确的ansible.cfg #

Semaphore可能在特殊环境运行，没加载到/etc/ansible/ansible.cfg：

• 看任务执行日志里的config file字段，确认是指定的配置文件
• 如果路径不对，在Semaphore项目设置里加ANSIBLE_CONFIG环境变量，指定完整的配置文件路径

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