Ansible传递主机名变量至角色失败，语法报错求助

你猜的完全没错！角色的tasks/main.yml里绝对不能包含完整的Play（也就是带hosts:的代码块），这是Ansible角色的核心规则——角色本质是可复用的任务集合（还包含变量、Handlers等资源），它本身不能定义目标主机，主机的选择应该在调用角色的外层Playbook里完成。

错误原因分析 #

你看到的unexpected parameter type in action错误，本质是Ansible解析角色的任务文件时，遇到了hosts:这个属于Play层级的参数。角色的任务文件只能包含任务（比如fetch、file这类模块调用），不能嵌套完整的Play结构，所以Ansible无法识别这个语法，才抛出了类型错误。

解决方案 #

下面提供两种符合Ansible规范的解决方式，你可以根据实际需求选择：

方案一：重构角色，分Play调用（推荐） #

把角色简化为纯任务集合，在外层Playbook里分两个Play分别指定目标主机：

1. 修改角色的tasks/main.yml，移除hosts:和外层的vars:块，只保留任务逻辑：

---
# roles/userdata/tasks/main.yml
- name: 从远程节点拉取文件到本地
  fetch:
    src: "{{ item }}"
    dest: "/path/to/item/"
    flat: yes
    fail_on_missing: no
  with_items:
    - "{{ first }}"
    - "{{ second }}"
    - "{{ third }}"
    - "{{ fourth }}"

- name: 删除远程节点上的tar文件
  file:
    path: "{{ item }}"
    state: absent
  with_items:
    - "{{ first }}"
    - "{{ second }}"
    - "{{ third }}"
    - "{{ fourth }}"

# 如果你需要删除本地拉取的文件，单独加这个任务
- name: 删除本地的tar文件
  file:
    path: "/path/to/item/{{ item | basename }}"
    state: absent
  with_items:
    - "{{ first }}"
    - "{{ second }}"
    - "{{ third }}"
    - "{{ fourth }}"
  delegate_to: localhost

2. 外层Playbook分Play调用角色，分别指定oldhost和newhost作为目标主机：

# playbook.yml
- hosts: "{{ oldhost }}"
  vars:
    oldhost: host1
    newhost: host2
    first: "$HOME/first.tar.gz"
    second: "$HOME/second.tar.gz"
    third: "$HOME/third.tar.gz"
    fourth: "$HOME/fourth.tar.gz"
  roles:
    - role: role1

- hosts: "{{ newhost }}"
  vars:
    oldhost: host1
    newhost: host2
    first: "$HOME/first.tar.gz"
    second: "$HOME/second.tar.gz"
    third: "$HOME/third.tar.gz"
    fourth: "$HOME/fourth.tar.gz"
  roles:
    - role: role1

方案二：用条件判断在单个Play中处理多主机 #

如果希望在一个Play里同时处理两个主机，可以给角色任务添加when条件，根据当前主机匹配变量执行对应操作：

1. 修改角色的tasks/main.yml，添加条件判断：

---
# roles/userdata/tasks/main.yml
- name: 从oldhost拉取文件到本地
  fetch:
    src: "{{ item }}"
    dest: "/path/to/item/"
    flat: yes
    fail_on_missing: no
  with_items:
    - "{{ first }}"
    - "{{ second }}"
    - "{{ third }}"
    - "{{ fourth }}"
  when: inventory_hostname == oldhost

- name: 删除oldhost上的tar文件
  file:
    path: "{{ item }}"
    state: absent
  with_items:
    - "{{ first }}"
    - "{{ second }}"
    - "{{ third }}"
    - "{{ fourth }}"
  when: inventory_hostname == oldhost

# 针对newhost的任务示例，如果有需要可以添加
- name: 在newhost上执行操作
  debug:
    msg: "正在newhost {{ newhost }}上执行任务"
  when: inventory_hostname == newhost

2. 外层Playbook调用角色，目标主机包含两个主机并传递变量：

# playbook.yml
- hosts: host1,host2
  vars:
    oldhost: host1
    newhost: host2
    first: "$HOME/first.tar.gz"
    second: "$HOME/second.tar.gz"
    third: "$HOME/third.tar.gz"
    fourth: "$HOME/fourth.tar.gz"
  roles:
    - role: role1

额外优化建议 #

你可以把路径变量（first、second等）放到角色的vars/main.yml里，这样不用每次调用角色都重复定义，让代码更整洁：

# roles/userdata/vars/main.yml
first: "$HOME/first.tar.gz"
second: "$HOME/second.tar.gz"
third: "$HOME/third.tar.gz"
fourth: "$HOME/fourth.tar.gz"

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