如何将Ansible中的data_list转换为带表头的CSV文件？

问题场景 #

将变量data_list转换为CSV时，所有数据集中在单行的多个单元格内，需要生成带指定表头（如FirstName、Alias Name等）的规范CSV，确保每个数据条目单独占一行。

假设data_list结构示例 #

data_list:
  - first_name: "John"
    alias_name: "Johnny"
    email: "john@example.com"
  - first_name: "Jane"
    alias_name: "Janie"
    email: "jane@example.com"

方法一：Jinja2模板生成CSV #

适合字段无特殊字符的简单场景。

1. 创建CSV模板文件（user_data.csv.j2） #

FirstName,Alias Name,Email
{% for item in data_list %}
{{ item.first_name }},{{ item.alias_name }},{{ item.email }}
{% endfor %}

2. Playbook任务 #

- name: 生成规范CSV文件
  template:
    src: user_data.csv.j2
    dest: /opt/output/user_data.csv

方法二：使用community.general.csv模块（推荐） #

适合字段含特殊字符（逗号、引号）的场景，自动处理CSV格式转义，避免格式错误。

1. 安装依赖集合 #

ansible-galaxy collection install community.general

2. Playbook任务 #

- name: 生成规范CSV文件
  community.general.csv:
    path: /opt/output/user_data.csv
    header:
      - FirstName
      - Alias Name
      - Email
    rows: "{{ data_list | json_query('[].{FirstName:first_name, \"Alias Name\":alias_name, Email:email}') }}"
    delimiter: ','

说明：通过json_query将data_list的原始字段映射为表头对应的键名，模块自动生成每行一条数据的标准CSV。

调试验证 #

可通过debug模块先确认输出格式是否符合预期：

- name: 调试CSV内容
  debug:
    msg: |
      FirstName,Alias Name,Email
      {% for item in data_list %}
      {{ item.first_name }},{{ item.alias_name }},{{ item.email }}
      {% endfor %}

预期输出：

FirstName,Alias Name,Email
John,Johnny,john@example.com
Jane,Janie,jane@example.com

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