推荐用 blockinfile 模块替换配置文件中的多行内容，因其专为成段配置设计，支持幂等增删改、自动标记识别；适用于 Nginx server 块等逻辑完整区段，而非单行参数或模糊替换。
在 Linux 中用 Ansible 替换配置文件里的多行内容，推荐用 blockinfile 模块，而不是 lineinfile 或 replace —— 因为它专为「有头有尾、成段存在」的配置块设计，天然支持幂等插入、更新、删除，还能自动加标记便于识别和后续维护。
什么时候该用 blockinfile 而不是其他模块
当你需要处理的是一个逻辑完整的配置段（比如 Nginx server 块、MySQL [mysqld] 区段、Docker daemon.json 的某个字段组），而不是单个参数或零散字符串时：
-
lineinfile：只适合改一行，比如
port = 8080；多行匹配易出错，且无法保证段落结构 - replace：会无差别替换所有匹配文本，可能误伤注释、日志或相似字符串，不感知配置语法边界
- blockinfile：把整段内容当一个原子单元管理，自带 marker 标识，增删改都安全可控
用 blockinfile 插入或覆盖一个配置块
核心是定义好 marker（默认是 # {mark} ANSIBLE MANAGED BLOCK）、block 内容，以及插入位置：
- 若目标块已存在 → 自动用新内容替换旧块（仅替换标记内的部分）
- 若不存在 → 在
insertafter或insertbefore指定位置插入整段 - 默认 marker 是可读的注释行，生产环境建议保留，方便人工识别 Ansible 管理范围
示例：在 /etc/nginx/conf.d/app.conf 中插入 server 块，并确保它出现在 http { 块内：
ansible.builtin.blockinfile:
path: /etc/nginx/conf.d/app.conf
block: |
server {
listen 8080;
server_name example.com;
root /var/www/app;
}
insertafter: '^http \{$'
marker: "# {mark} NGINX APP SERVER"
backup: yes
安全删除或禁用已有配置块
只需把 state 设为 absent，Ansible 会精准移除从 marker 开始到下一个同名 marker（或文件末尾）之间的全部内容：
- 不会误删其他无关行，哪怕中间有空行或注释
- marker 必须完全一致（包括空格和大小写）
- 建议配合
backup: yes，避免误删后无法恢复
示例：移除上面插入的 server 块：
- name: Remove Nginx app server blockansible.builtin.blockinfile:
path: /etc/nginx/conf.d/app.conf
state: absent
marker: "# {mark} NGINX APP SERVER"
backup: yes
关键注意事项
实际使用中容易忽略但影响稳定的几点：
-
路径必须绝对且存在：如果文件不存在，需先用
file模块创建，或设create: yes（仅限 blockinfile 2.10+） -
缩进要统一：YAML 中的
|会保留换行和空格，建议用 2 或 4 空格缩进，避免混用 tab -
验证语法再重载：修改后应调用
validate（如nginx -t %s）并触发服务重载，否则可能配错导致服务宕机 -
避免 marker 冲突：多个 block 不要用相同 marker；若需动态生成（如按主机名），可用
"# {mark} CONFIG FOR {{ ansible_hostname }}"
