Ansible：基于字典模板批量生成ProFTPD配置文件

需求与现有资源 #

需要基于唯一数据源批量生成ProFTPD配置文件，每个上传组对应一个独立配置文件，数据源结构如下：

uploaders:
  - name: 'Uploaders from one location'
    initials: 'abc'
    ftps_limit_list: 'LIST PWD xpwd'
    variable_used_by_another_playbook: 'fubar'
  - name: 'Uploaders from a second location'
    initials: 'dfg'
  - name: 'Test Uploader'
    initials: 'TestUploader'
    ftps_upload_directory: '/path/to/TestUploader/uploads'

使用的模板片段conf.d.j2：

{% if ftps_upload_directory is defined %}
<Directory {{ ftps_upload_directory }}>
{% else %}
<Directory /path/to/{{ initials|upper }}/uploads>
{% endif %}

<snip>

<Limit LOGIN>
AllowGroup uploader-{{ initials|lower }}
Deny ALL
</Limit>

<snip>

{% if ftps_limit_list is defined %}
<Limit {{ ftps_limit_list }}>
{% else %}
<Limit LIST MLSD MLST NLST SIZE>
{% endif %}
AllowAll
</Limit>

预期生成abc.conf、dfg.conf、TestUploader.conf三个配置文件，但当前执行的任务未成功：

- name: Copy in the configs for various labs
  template:
    src: conf.d.j2
    dest: "/etc/proftpd/conf.d/{{ item.initials }}.conf"
    mode: '0644'
    owner: root
    group: root
  with_dict: "{{ uploaders }}"

错误原因 #

uploaders是列表类型（list），但任务中错误使用了with_dict（该关键字用于遍历字典的键值对），导致无法正确遍历列表中的每个上传组项。

修复方案 #

将遍历关键字替换为适合列表的loop（Ansible 2.5+推荐标准语法）或with_items，修改后的任务如下：

- name: Copy in the configs for various labs
  template:
    src: conf.d.j2
    dest: "/etc/proftpd/conf.d/{{ item.initials }}.conf"
    mode: '0644'
    owner: root
    group: root
  loop: "{{ uploaders }}"

扩展性优化建议 #

为简化模板逻辑、提升可维护性，可使用default过滤器替换模板中的if/else判断，让代码更简洁易维护：

<Directory {{ ftps_upload_directory | default('/path/to/' ~ initials|upper ~ '/uploads') }}>

<snip>

<Limit LOGIN>
AllowGroup uploader-{{ initials|lower }}
Deny ALL
</Limit>

<snip>

<Limit {{ ftps_limit_list | default('LIST MLSD MLST NLST SIZE') }}>
AllowAll
</Limit>

这种方式统一管理默认值，后续修改默认配置时只需调整过滤器参数即可，无需修改分支判断逻辑。

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