运行Ansible debug临时命令时变量未定义问题咨询

现象 #

• 使用以下Ansible剧本打印远程主机centos1的IPv4地址时，执行正常：

---
- hosts: centos1
  tasks:
    - name: Print ip address
      debug:
        msg: "ip: {{ansible_all_ipv4_addresses[0]}}"

• 但执行如下debug模块临时命令时失败：

ansible -i hosts centos1 -m debug -a 'msg={{ansible_all_ipv4_addresses[0]}}'

报错信息：

centos1 | FAILED! => {
"msg": "The task includes an option with an undefined variable. The error was: 'ansible_all_ipv4_addresses' is undefined.
'ansible_all_ipv4_addresses' is undefined" }

用户预期两种方式都能正常打印IP，但临时命令出现变量未定义错误。

核心原因 #

两者的关键差异在于事实（Facts）的自动收集机制：

• Ansible剧本默认在执行任务前，会自动触发setup模块收集远程主机的事实数据，其中就包含ansible_all_ipv4_addresses这类系统网络信息，因此剧本中可以直接调用该变量。
• Ansible临时命令（ad-hoc）默认不会自动收集事实数据，ansible_all_ipv4_addresses属于事实变量，没有提前收集的话，临时命令执行时自然找不到这个变量，从而报错。

解决办法 #

要让临时命令正常获取IP，可通过以下两种方式实现：

1. 先单独执行setup模块收集事实，再运行debug命令：

ansible -i hosts centos1 -m setup
ansible -i hosts centos1 -m debug -a 'msg={{ansible_all_ipv4_addresses[0]}}'

2. 在临时命令中强制开启事实收集，或者直接用setup模块过滤提取IP：

# 方式一：强制收集事实后执行debug
ansible -i hosts centos1 -m debug -a 'msg={{ansible_all_ipv4_addresses[0]}}' -e 'gather_facts=True'
# 方式二：直接用setup模块过滤获取IP列表
ansible -i hosts centos1 -m setup -a 'filter=ansible_all_ipv4_addresses'

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