ANSIBLE.TEMPLATE(3)

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)."

NOTES

Since Ansible version 0.9, templates are loaded with trim_blocks=True.

You can override jinja2 settings by adding a special header to template file. i.e. c(#jinja2: trim_blocks: False)

EXAMPLES

Example from Ansible Playbooks
template: src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644
None

AUTHOR
Michael DeHaan

SEE ALSO
ansible(1), http://ansible.github.com/modules.html#template