win_lineinfile – Гарантировать наличие определённой строки в файле или заменить существующую строку с использованием обратной ссылки в регулярном выражении

• Обзор
• Параметры
• Примечания
• Примеры
• Статус

Обзор

• Этот модуль ищет строку в файле и гарантирует, что она присутствует или отсутствует.
• Это в первую очередь полезно, когда вы хотите изменить только одну строку в файле.

Параметры

Примечания

Примеры

# Before 2.3, option 'dest', 'destfile' or 'name' was used instead of 'path'
- name: insert path without converting \r\n
  win_lineinfile:
    path: c:\file.txt
    line: c:\return\new

- win_lineinfile:
    path: C:\Temp\example.conf
    regexp: '^name='
    line: 'name=JohnDoe'

- win_lineinfile:
    path: C:\Temp\example.conf
    regexp: '^name='
    state: absent

- win_lineinfile:
    path: C:\Temp\example.conf
    regexp: '^127\.0\.0\.1'
    line: '127.0.0.1 localhost'

- win_lineinfile:
    path: C:\Temp\httpd.conf
    regexp: '^Listen '
    insertafter: '^#Listen '
    line: Listen 8080

- win_lineinfile:
    path: C:\Temp\services
    regexp: '^# port for http'
    insertbefore: '^www.*80/tcp'
    line: '# port for http by default'

# Create file if it doesn't exist with a specific encoding
- win_lineinfile:
    path: C:\Temp\utf16.txt
    create: yes
    encoding: utf-16
    line: This is a utf-16 encoded file

# Add a line to a file and ensure the resulting file uses unix line separators
- win_lineinfile:
    path: C:\Temp\testfile.txt
    line: Line added to file
    newline: unix

# Update a line using backrefs
- win_lineinfile:
    path: C:\Temp\example.conf
    backrefs: yes
    regexp: '(^name=)'
    line: '$1JohnDoe'

Статус

• Этот модуль не гарантирует обратную совместимость. [превью]
• Этот модуль поддерживается сообществом Ansible. [community]

Авторы

• Brian Lloyd (@brianlloyd)