Ansible Playbook使用group_vars/all.yml变量提示未定义的问题

问题场景 #

需要先执行创建服务器的角色获取目标IP，计划通过group_vars/all.yml存储的IP动态设置playbook的hosts值，相关配置及错误如下：

playbook.yml #

- name: do_something
  hosts: 
    - "{{ NETWORK.IP }}"
  roles:
    - my_role

group_vars/all.yml #

NETWORK:
    IP: 10.0.0.1

执行错误 #

$ ansible-playbook playbook.yml
...
ERROR! The field 'hosts' has an invalid value, which includes an undefined variable. The error was: 'NETWORK' is undefined

The error appears to be in 'playbook.yml': line X, column Y, but may
be elsewhere in the file depending on the exact syntax problem.

已尝试操作：

• 在localhost的前置任务中使用set_facts模块设置变量
• 在playbook中启用gather_facts
• 使用vars_file引入group_vars/all.yml

补充验证：针对localhost的play可正常获取NETWORK.IP：

- name: do_something2
  hosts: localhost
  tasks:
    - set_fact:
        MY_HOST: "{{ NETWORK.IP }}"

环境信息：

ansible [core 2.13.3]
  config file = /etc/ansible/ansible.cfg
  configured module search path = ['SOME_PATH', '/usr/share/ansible/plugins/modules']
  ansible python module location = SOME_PATH
  ansible collection location = SOME_PATH
  executable location = SOME_PATH
  python version = 3.10.8 (main, Oct 19 2022, 07:46:20) [GCC]
  jinja version = 3.1.2
  libyaml = True

运行系统：openSUSE Leap

问题原因 #

Ansible解析hosts字段属于初始化阶段，此时还未加载group_vars/all.yml中的变量。group_vars的变量是和inventory中的主机/组关联加载的，只有当play针对某个已存在的主机（比如默认存在的localhost）时，Ansible才会加载对应的组变量。直接在hosts字段使用未初始化的变量，自然会提示变量未定义。

而针对localhost的play能正常获取变量，是因为localhost默认存在于inventory中，Ansible会自动将group_vars/all.yml的变量加载到localhost的上下文里，所以tasks中可以正常访问。

解决方法 #

方法1：使用add_host创建临时主机组 #

先通过localhost的play完成服务器创建，再将目标IP添加到临时组，后续play针对临时组执行：

- name: 创建服务器并注册目标IP
  hosts: localhost
  tasks:
    # 执行创建服务器的角色，确保NETWORK.IP被正确设置
    - include_role:
        name: create_server
    # 将新服务器IP添加到临时组target_servers
    - add_host:
        name: "{{ NETWORK.IP }}"
        groups: target_servers

- name: 在目标服务器执行任务
  hosts: target_servers
  roles:
    - my_role

方法2：显式通过vars_files加载变量文件 #

在play中直接指定vars_files，确保变量在解析hosts字段前被加载（注意路径要正确，若playbook不在项目根目录，需调整为相对/绝对路径）：

- name: do_something
  hosts: "{{ NETWORK.IP }}"
  vars_files:
    - ./group_vars/all.yml
  roles:
    - my_role

方法3：命令行传递变量 #

运行playbook时，通过-e参数直接传递变量或加载变量文件：

# 直接传递变量
ansible-playbook playbook.yml -e "NETWORK.IP=10.0.0.1"

# 从文件加载变量
ansible-playbook playbook.yml -e @group_vars/all.yml

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