ansible.template(3) - Linux man page
Name
template - Templates a file out to a remote server.
Description
Templates are processed by the Jinja2 templating language (http://jinja.pocoo.org/docs/) - documentation on the template formatting can be found in the Template Designer Documentation (http://jinja.pocoo.org/docs/templates/).
Six additional variables can be used in templates: ansible_managed (configurable via the defaults section of ansible.cfg) contains a string which can be used to describe the template name, host, modification time of the template file and the owner uid, template_host contains the node name of the template's machine, template_uid the owner, template_path the relative path of the template, template_fullpath is the absolute path of the template, and template_run_date is the date that the template was rendered.
Options
- backup
Create a backup file including the timestamp
- information so you can get the original file back if you somehow clobbered it incorrectly. Choices: yes,no. (default: no)
- dest
Location to render the template to on the remote machine.(required)
others
all arguments accepted by the file module also work here
src
Path of a Jinja2 formatted template on the local server. This can be a relative or absolute path.(required)."
- information so you can get the original file back if you somehow clobbered it incorrectly. Choices: yes,no. (default: no)
Notes
Since Ansible version 0.9, templates are loaded with trim_blocks=True.
Examples
Example from Ansible Playbooks
template: src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644
Author
Michael DeHaan