如何用Ansible Playbook向文件中首次出现的指定行末尾追加字符串

现有文件内容 #

Label abc
First line
Second line
Append line at the end of this line
Append line at the end of this line
Append line at the end of this line
Last line

需求 #

将字符串added string追加到Append line at the end of this line首次出现的行末尾，期望结果如下：

Label abc
First line
Second line
Append line at the end of this line added string 
Append line at the end of this line
Append line at the end of this line
Last line

问题现象 #

尝试了以下Playbook，但整个文件内容被错误修改：

- name: Replace only the first occurrence of a line in a file and append values
  hosts: localhost
  tasks:
    - name: Read the file content
      slurp:
        path: /path/to/your/file
      register: file_content

    - name: Modify only the first occurrence of the line and append values
      set_fact:
        updated_lines: >-
          {%- set found = False -%}
          {%- for line in (file_content.content | b64decode).split('\n') -%}
            {%- if not found and line.startswith('label Linux') -%}
              {%- set found = True -%}
              {{ line + ' your_append_text' }}
            {%- else -%}
              {{ line }}
            {%- endif -%}
          {%- endfor -%}

    - name: Write the modified content back to the file
      copy:
        content: "{{ updated_lines | join('\n') }}"
        dest: /path/to/your/file
        backup: yes

问题原因 #

1. 判断条件错误：原Playbook用line.startswith('label Linux')匹配目标行，和实际需要修改的Append line at the end of this line完全不符，导致修改逻辑从未触发。
2. 格式处理错误：使用>-折叠块生成updated_lines，会把循环输出的所有行合并成单个字符串，后续用join('\n')会彻底打乱文件的换行结构，这是文件内容被破坏的核心原因。

正确的Playbook写法 #

写法一（逐行循环处理） #

- name: 仅追加字符串到指定行的首次出现末尾
  hosts: localhost
  tasks:
    - name: 读取文件内容
      slurp:
        path: /path/to/your/file
      register: file_content

    - name: 逐行处理，仅修改目标行的首次出现
      set_fact:
        updated_lines: "{{ updated_lines | default([]) + [line ~ ' added string'] if (not found_flag and line == 'Append line at the end of this line') else updated_lines | default([]) + [line] }}"
      loop: "{{ (file_content.content | b64decode).split('\n') }}"
      vars:
        found_flag: "{{ updated_lines | default([]) | select('search', 'added string') | length > 0 }}"

    - name: 将修改后的内容写回文件
      copy:
        content: "{{ updated_lines | join('\n') }}"
        dest: /path/to/your/file
        backup: yes

写法二（Jinja2列表生成） #

- name: 仅追加字符串到指定行的首次出现末尾
  hosts: localhost
  tasks:
    - name: 读取文件内容
      slurp:
        path: /path/to/your/file
      register: file_content

    - name: 生成修改后的行列表
      set_fact:
        updated_lines: >
          {% set found = False %}
          {% set lines = [] %}
          {% for line in (file_content.content | b64decode).split('\n') %}
            {% if not found and line == 'Append line at the end of this line' %}
              {% do lines.append(line ~ ' added string') %}
              {% set found = True %}
            {% else %}
              {% do lines.append(line) %}
            {% endif %}
          {% endfor %}
          {{ lines }}

    - name: 写回文件
      copy:
        content: "{{ updated_lines | join('\n') }}"
        dest: /path/to/your/file
        backup: yes

说明 #

两种写法核心都是生成行列表而非拼接字符串，确保文件的换行结构不受破坏；同时修正了匹配条件，准确找到目标行的首次出现并追加内容。

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