lineinfile

Create or configure lines in a file.

Parameters

Parameter		Type	Comments
path		string required	Path to file.
lines		list required	lineinfile params. Either dict or lines is required.
	regexp	string required	Regular expression.
	line	string required	Line
	backrefs
	state
	firstmatch
	insertafter
	insertbefore
	…	…	<TBD>
assignment		string	Assignment of key and value in dict.
dict		list required	lineinfile params. Either dict or lines is required. (see files-lineinfile.yml)
	key	string required	Key value for regexp.
	value	string required	Value for line.
	firstmatch
	insertafter
	insertbefore
	…	…	<TBD>
owner		string	Owner of the file.
group		string	Group of the file.
mode		string	Mode of the file.
attributes		string	Attributes of the file.
other		string	Attributes of module file.
create		boolean	Create file.
validate		string	Command to validate file.
handlers		list	List of handlers.

Example

File /usr/local/etc/dma/dma.conf for DragonFly Mail Agent

[contrib/dma/conf-light/files.d/dma-dmaconf.yml]

---
dma_dmaconf:
  path: /usr/local/etc/dma/dma.conf
  create: true
  owner: root
  group: mail
  mode: "0644"
  lines: "{{ cl_dma_dmaconf_lines }}"

[contrib/dma/host_vars/srv.example.com/config-light-dma.yml]

cl_dma_dmaconf_lines:
  - { regexp: ^SMARTHOST\s*(.*)$, line: "SMARTHOST {{ cl_dma_smarthost }}" }
  - { regexp: ^PORT\s*(.*)$, line: "PORT {{ cl_dma_port }}" }
  - { regexp: ^AUTHPATH\s*(.*)$, line: "AUTHPATH {{ cl_dma_authpath }}" }
  - { regexp: ^ALIASES\s*(.*)$, line: "ALIASES {{ cl_dma_aliasespath }}" }
  - { regexp: ^SECURETRANSFER\s*(.*)$, line: SECURETRANSFER }
  - { regexp: ^STARTTLS\s*(.*)$, line: STARTTLS }
  - { regexp: ^MASQUERADE\s*(.*)$, line: "MASQUERADE {{ cl_dma_masquerade }}" }

Example of lineinfile with dict

File /usr/local/etc/lighttpd/lighttpd.conf for lighttpd

[contrib/lighttpd/conf-light/files.d/lighttpd-lighttpdconf.yml]

---
lighttpd-lighttpdconf:
  path: /usr/local/etc/lighttpd/lighttpd.conf
  create: true
  owner: root
  group: wheel
  mode: "0644"
  assignment: " = "
  dict: "{{ cl_lighttpd_lighttpdconf_dict }}"
  handlers:
    - reload lighttpd

[contrib/lighttpd/host_vars/srv.example.com/cl-lighttpd.yml]

cl_lighttpd_server_document_root: /usr/local/www/lighttpd
cl_lighttpd_lighttpdconf_dict:
  - { key: server.port, value: '"{{ cl_lighttpd_server_port }}"' }
  - { key: server.use-ipv6, value: '"{{ cl_lighttpd_server_useipv6 }}"' }
  - { key: server.username, value: '"{{ cl_lighttpd_server_username }}"' }
  - { key: server.groupname, value: '"{{ cl_lighttpd_server_groupname }}"' }

See also

• See files-lineinfile.yml at GitHub how the files are modified or created by the Ansible module lineinfile

• See files-lineinfile.yml annotated source code