如何在Ansible中遍历配置特定主机变量的主机数组？

问题分析 #

你需要在控制节点上，针对库存中配置了longhorn.storage=true的主机，执行kubectl label命令给对应的K8s节点打标签。之前尝试访问主机变量时报错，核心问题是未处理变量不存在的场景，以及循环方式有误。

解决方案 #

通过Jinja2列表推导式筛选符合条件的主机，再循环执行命令。以下是完整的Playbook示例：

- name: 为Longhorn存储节点添加Kubernetes标签
  hosts: controlplanes
  gather_facts: false
  vars:
    # 筛选出workers组中配置longhorn.storage=true的主机
    longhorn_storage_nodes: "{{ 
      [item for item in groups['workers'] 
       if hostvars[item].get('longhorn', {}).get('storage') | bool] 
    }}"

  tasks:
    - name: 打印符合条件的节点列表
      debug:
        msg: "待打标签的K8s节点: {{ longhorn_storage_nodes }}"

    - name: 执行kubectl标签命令
      command: >
        kubectl label nodes {{ item }} longhorn.io/storage=true --overwrite
      loop: "{{ longhorn_storage_nodes }}"
      # 仅当有符合条件的节点时才执行
      when: longhorn_storage_nodes | length > 0

关键细节说明 #

1. 变量安全访问：
   用hostvars[item].get('longhorn', {}).get('storage')替代直接访问hostvars[item].longhorn.storage，get方法会在变量不存在时返回默认值（这里是空字典/None），避免抛出"未定义"错误。最后加| bool确保值被转为布尔型，兼容字符串'true'或布尔true两种配置方式。

2. 精准筛选范围：
   直接遍历groups['workers']而非all组，缩小筛选范围，提升效率。

3. 避免空循环：
   通过when: longhorn_storage_nodes | length > 0判断，确保只有存在符合条件的节点时才执行kubectl命令，防止无意义的空循环。

4. 关闭无用facts收集：
   设置gather_facts: false，因为不需要收集控制节点的系统信息，加快Playbook执行速度。

修正你之前的测试Playbook #

如果要调试主机变量，正确的循环方式应该是直接遍历组内主机，而非把整个组作为单个元素：

- name: Loop Test
  hosts: controlplanes
  gather_facts: false
  tasks:
    - debug:
        msg: "主机: {{ item }}, longhorn.storage值: {{ hostvars[item].get('longhorn', {}).get('storage', '未配置') }}"
      loop: "{{ groups['workers'] }}"

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