正确写法是用 YAML 的 | 语法保留换行，如 block: | upstream backend { server 10.0.1.10:8080; server 10.0.1.11:8080; keepalive 32; }，并配合 ^http\s*{ 等带锚点的正则确保精准插入。
blockinfile模块插入多行配置的正确写法
直接用 blockinfile 插入多行内容是可行的，但必须注意换行符和缩进处理——Ansible 默认会把 insertafter 或 insertbefore 匹配到的行当作锚点，然后把整个 block 内容（含换行）原样插入其后或其前。常见错误是写成 YAML 多行字符串却忘了保留换行，导致所有配置被压成一行。
推荐用 YAML 的 |（literal block scalar）语法，并确保每行缩进一致（不缩进或统一缩进 2 空格均可，但块内不能混用制表符）：
- name: 插入 Nginx upstream 配置块
blockinfile:
path: /etc/nginx/conf.d/app.conf
block: |
upstream backend {
server 10.0.1.10:8080;
server 10.0.1.11:8080;
keepalive 32;
}
insertafter: "^http {"
state: presentinsertafter/insertbefore 正则匹配的坑
这两个参数接受正则表达式，但默认启用的是 Python 的 re.search，不是完整行匹配。如果写 insertafter: "http {"，可能意外匹配到注释里的 http {；更危险的是，若目标文件里有多个匹配行，blockinfile 只会在最后一个匹配行后插入（这是设计行为，不是 bug）。
- 务必用锚点限定范围，例如
insertafter: "^http\s*{"比"http {"安全 - 避免跨行匹配：正则不支持
.匹配换行符，所以不要试图用insertbefore: "^\s*# end of.*\n.*server"这类写法 - 调试时加
check_mode: yes和ansible-playbook -vv，看日志里实际匹配到了哪几行
如何确保多次运行不重复插入
blockinfile 依赖标记（marker）识别已有块，默认 marker 是 # BEGIN ANSIBLE MANAGED BLOCK 和 # END ANSIBLE MANAGED BLOCK。只要 marker 不被手动删改，重复运行不会叠加内容。
但要注意：
- 如果修改了
block内容，模块会原地替换整个块（保留 marker 行） - 如果手动删掉了 marker 行，下次运行会当成新块再插一份——此时文件里就出现两份相同配置
- 可以用
marker: "# {mark} CONFIG BACKEND BLOCK"自定义 marker，便于 grep 定位
替换已有配置块而不是追加
没有“替换”动作，只有“保证存在”（state: present）或“删除块”（state: absent）。要实现“替换”，本质是先删后插，但不能靠两个 task 顺序执行——因为中间状态可能被其他进程读取。
更稳妥的做法是：用同一个 blockinfile task，保持 marker 不变，只更新 block 值。Ansible 会自动比对内容差异，仅当 block 内容变化时才重写。
如果旧配置格式混乱（比如 marker 被破坏、缩进错乱），建议先用 lineinfile 清理 marker 行，再用 blockinfile 重建。
真正麻烦的是嵌套结构里插块，比如在某个 location /api { ... } 内部插入 proxy_set_header 多行——这时 insertafter 很难精确定位，不如改用 replace 模块配合正则捕获组，或者拆成模板文件用 template 模块覆盖。
