如何在Ansible自定义Action Plugin中调用set_fact设置变量

问题本质 #

你遇到的核心问题有两个：

1. ansible_python_interpreter是主机级特殊变量，而非普通fact，默认调用set_fact只会设置临时fact，不会覆盖主机变量。
2. 通过self._execute_module调用set_fact的返回结果不会自动合并到当前上下文的task_vars中，后续任务无法读取新值。

解决方案一：直接修改task_vars（最可靠） #

Action Plugin可以直接访问并修改task_vars字典，这是设置主机变量最直接的方式，无需调用set_fact模块：

def run(self, tmp=None, task_vars=None):
    # 直接更新task_vars中的ansible_python_interpreter
    task_vars['ansible_python_interpreter'] = '/path/to/python'
    
    # 可选：如果需要将变量同步到主机facts中，使用基类的_set_fact方法
    self._set_fact('ansible_python_interpreter', '/path/to/python', task_vars)
    
    # 后续任务会自动读取到更新后的变量
    return super().run(tmp, task_vars)

_set_fact是Action Plugin基类提供的方法，会自动处理fact的存储和task_vars的更新，比手动调用模块更稳定。

解决方案二：正确调用set_fact并合并结果 #

如果必须通过set_fact模块实现，需要注意三个关键点：

• 直接传递变量键值对作为模块参数，无需key_value嵌套
• 添加cacheable: True参数，让变量持久化为主机级变量
• 手动将模块返回的fact合并到task_vars中

代码示例：

def run(self, tmp=None, task_vars=None):
    # 正确调用set_fact模块
    result = self._execute_module(
        module_name='ansible.builtin.set_fact',
        module_args={
            'ansible_python_interpreter': '/path/to/python',
            'cacheable': True  # 必须：让变量可缓存，成为主机持久变量
        },
        task_vars=task_vars
    )
    
    # 手动合并返回的fact到task_vars，确保后续任务可见
    if 'ansible_facts' in result:
        task_vars.update(result['ansible_facts'])
        # 更新模板上下文，确保后续任务能读取到新变量
        self._templar.set_available_variables(task_vars)
    
    return result

为什么之前的写法无效？ #

你尝试的三种module_args写法都存在问题：

1. 第一种写法缺少cacheable: True，导致变量只是临时fact，不会覆盖主机级的ansible_python_interpreter
2. 第二、三种写法错误使用了key_value参数，set_fact模块不需要这个参数，直接传递变量键值对即可

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