Ansible Playbook任务层引用全局变量报错的修正方案咨询

• 报错和变量引用逻辑完全无关，根源是Playbook结构层级错误：hosts、vars、vars_files、roles均为Play级别的合法配置字段，不可嵌套在tasks列表下的单个Task条目内。Ansible解析时会将这些字段识别为Task的执行参数，尤其是roles属于列表类型，Task本身不支持接收这类参数，直接抛出“意外参数类型”的语法错误，整个解析流程在结构校验阶段就终止，根本未进入变量渲染环节。
• 此前将报错归因于task内vars块中{{ os_project }}的变量引用，属于判断偏差：由于结构错误，Ansible尚未启动变量解析流程就已中断。

将所有Play级配置上移至最外层的Play定义下，全局统一的项目、租户变量仅在顶层定义一次，多环境差异化配置直接引用全局变量即可，正确结构如下：

- name: Deploy OpenStack Instances
  hosts: localhost
  # 全局统一复用的项目/租户变量，所有部署场景通用，仅需定义一次
  vars:
    os_project: "supercoolproject_ng"
    os_tenant: "supercooltenant"
  # 敏感变量文件，Play级挂载
  vars_files:
    - "{{ secrets_file }}"
  roles:
    # 第一套环境部署配置，直接引用顶层全局项目/租户变量
    - role: adm_openstack_deploy_instance
      vars:
        openstack:
          state: present
          locality: ng
          project: "{{ os_project }}"
          tenant: "{{ os_tenant }}"
          zone: row-r
          image: debian-10-amd64
          security_groups:
            - base
          server_group: wobani-servergroup
          instances:
            wobani01: t1.4c4r50d
    # 如需新增其他可用区/地域的部署，直接追加角色调用条目即可，无需重复填写项目、租户信息
    # - role: adm_openstack_deploy_instance
    #   vars:
    #     openstack:
    #       state: present
    #       locality: eu
    #       project: "{{ os_project }}"
    #       tenant: "{{ os_tenant }}"
    #       zone: eu-central-1
    #       image: debian-12-amd64
    #       instances:
    #         wobani02: t1.2c2r50d

• 结构修正后，Ansible语法校验可正常通过，不会再触发此前的参数类型报错
• 顶层定义的os_project、os_tenant可被所有角色调用块正常引用，渲染后的值与硬编码效果完全一致
• 后续扩展多环境部署时，仅需在roles列表中追加对应环境的差异化配置（可用区、镜像、实例规格等），全局统一的项目、租户配置无需重复编写，满足降低重复配置成本的核心需求

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