Ansible ini_file模块未创建不存在文件的问题排查与解决

1. 问题产生的原因及是否存在配置遗漏？ #

这个问题不是你的配置遗漏，完全是Ansible ini_file模块的已知Bug（编号#30599）导致的。

该Bug的核心逻辑问题是：当目标INI文件完全不存在时，模块内部会先尝试读取文件内容，若文件不存在则直接抛出错误，并不会执行create=yes参数对应的创建逻辑。哪怕你在任务中正确设置了create: yes，这个Bug也会阻止模块自动生成新文件。

2. 当前已知的解决方案 #

在官方修复合并前，有几个可行的替代方案：

方案一：先手动创建空文件（你目前使用的临时方案的细化版）

先用file模块创建空文件，再用ini_file更新参数，确保文件存在后再进行修改：

- name: 确保dnscloudflare.ini文件存在（创建空文件）
  file:
    path: /etc/letsencrypt/dnscloudflare.ini
    state: touch
    owner: root
    group: root
    mode: '0600'  # API密钥文件需严格限制权限

- name: 更新dns_cloudflare_api_key参数
  ini_file:
    path: /etc/letsencrypt/dnscloudflare.ini
    section: ''  # 若参数不在任何section下，用空字符串
    option: dns_cloudflare_api_key
    value: "{{ cloudflare_api_key }}"
    create: yes
    mode: '0600'

方案二：结合copy模块使用模板初始化文件

如果需要预先设置其他INI配置项，可以用Jinja2模板先初始化文件，再用ini_file更新：

- name: 拷贝dnscloudflare.ini模板（仅文件不存在时执行）
  copy:
    src: templates/dnscloudflare.ini.j2
    dest: /etc/letsencrypt/dnscloudflare.ini
    owner: root
    group: root
    mode: '0600'
    force: no  # 避免覆盖已存在的配置

- name: 更新Cloudflare API密钥
  ini_file:
    path: /etc/letsencrypt/dnscloudflare.ini
    option: dns_cloudflare_api_key
    value: "{{ cloudflare_api_key }}"
    mode: '0600'

方案三：用lineinfile模块替代（更轻量化）

如果不需要严格处理INI的section结构，lineinfile模块可以直接创建文件并添加/修改目标行：

- name: 设置dns_cloudflare_api_key（自动创建文件）
  lineinfile:
    path: /etc/letsencrypt/dnscloudflare.ini
    line: "dns_cloudflare_api_key = {{ cloudflare_api_key }}"
    regexp: '^dns_cloudflare_api_key\s*='
    create: yes
    owner: root
    group: root
    mode: '0600'

另外，你可以持续关注Bug#30599的修复进度，待官方合并修复后，就能直接使用ini_file模块的create=yes参数完成文件创建+参数更新的操作了。

内容的提问来源于stack exchange，提问作者Mohd Abdul Mujib