Ansible远程主机取值写入本地文件异常及数据收集最佳实践问询

问题根源 #

你当前的剧本大概率是让每个远程主机单独通过local_action或delegate_to往本地文件追加内容。但Ansible默认并行执行任务（默认forks数为5），多个主机的写入操作同时触发，会导致文件写入冲突，最终只有部分主机的数据被保留。

解决方案：先收集所有数据，再统一写入 #

正确的思路是先在所有远程主机上收集数据，存储到Ansible变量中，最后统一执行一次本地写入操作，彻底避免并行写入的冲突。

示例剧本 #

- name: 收集远程主机的setting_key值
  hosts: all
  gather_facts: false
  tasks:
    - name: 读取ini文件中的setting_key（无section场景）
      ini_file:
        path: /mydir/myfile.ini
        section: ''  # 若setting_key属于某个section，替换为对应section名（如[main]则填main）
        option: setting_key
        state: present
      register: setting_result

    - name: 绑定主机名与配置值到变量
      set_fact:
        host_setting: "{{ inventory_hostname }}: {{ setting_result.value }}"

- name: 将所有数据统一写入本地文件
  hosts: localhost
  gather_facts: false
  tasks:
    - name: 追加所有主机配置到my_settings.txt
      lineinfile:
        path: ./my_settings.txt
        line: "{{ item }}"
        state: present
        create: true  # 文件不存在则自动创建
      loop: "{{ groups['all'] | map('extract', hostvars, 'host_setting') | list }}"

替代方案（用shell读取ini值） #

如果你的环境不适合用ini_file模块，也可以用shell命令读取：

- name: 读取ini文件中的setting_key
  shell: grep -E "^setting_key=" /mydir/myfile.ini | cut -d'=' -f2
  register: setting_result
  changed_when: false

- name: 绑定主机名与配置值到变量
  set_fact:
    host_setting: "{{ inventory_hostname }}: {{ setting_result.stdout.strip() }}"

完全适合。批量收集节点数据是Ansible的核心场景之一，比如：

• 汇总硬件信息、系统配置
• 收集节点状态到本地文件或数据库
• 生成合规审计、节点对比报告

它的优势在于：

• 无需在节点上安装客户端，仅依赖SSH即可
• 内置大量模块（setup、ini_file等）快速获取结构化数据
• 支持将数据输出为JSON、CSV、YAML等格式，方便后续分析
• 可灵活通过变量、facts存储和处理收集到的数据

可以按“收集数据→统一处理→生成报告”的流程实现，以下是具体示例：

示例：生成Markdown格式的节点对比报告 #

- name: 收集节点核心数据
  hosts: all
  gather_facts: false
  tasks:
    - name: 读取setting_key配置
      ini_file:
        path: /mydir/myfile.ini
        section: main
        option: setting_key
      register: setting_key_result

    - name: 获取操作系统版本
      command: cat /etc/os-release | grep PRETTY_NAME | cut -d'"' -f2
      register: os_version_result
      changed_when: false

    - name: 存储节点结构化数据
      set_fact:
        node_data:
          hostname: "{{ inventory_hostname }}"
          setting_key: "{{ setting_key_result.value }}"
          os_version: "{{ os_version_result.stdout.strip() }}"

- name: 生成Markdown对比报告
  hosts: localhost
  gather_facts: false
  tasks:
    - name: 拼接报告内容
      set_fact:
        report_content: |
          # 节点配置对比报告
          | 主机名 | Setting Key值 | 操作系统版本 |
          |--------|---------------|--------------|
          {% for host in groups['all'] %}
          | {{ hostvars[host]['node_data']['hostname'] }} | {{ hostvars[host]['node_data']['setting_key'] }} | {{ hostvars[host]['node_data']['os_version'] }} |
          {% endfor %}

    - name: 写入本地报告文件
      copy:
        content: "{{ report_content }}"
        dest: ./node_comparison_report.md
        mode: '0644'

进阶：将数据写入数据库 #

如果要把收集的数据存入MySQL、PostgreSQL等数据库，可以用Ansible对应的数据库模块，比如MySQL的示例：

- name: 将节点数据写入MySQL
  hosts: localhost
  gather_facts: false
  tasks:
    - name: 插入数据到数据库表
      mysql_query:
        login_host: db.example.com
        login_user: db_user
        login_password: db_pass
        db: node_monitor
        query: "INSERT INTO node_settings (hostname, setting_key, os_version) VALUES (%s, %s, %s)"
        args:
          - "{{ hostvars[host]['node_data']['hostname'] }}"
          - "{{ hostvars[host]['node_data']['setting_key'] }}"
          - "{{ hostvars[host]['node_data']['os_version'] }}"
      loop: "{{ groups['all'] }}"

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