mirror of https://github.com/ansible/ansible.git
You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
42 lines
1.3 KiB
Groff
42 lines
1.3 KiB
Groff
.TH ANSIBLE.TEMPLATE 5 "2012-10-03" "0.8" "ANSIBLE MODULES"
|
|
." generated from library/template
|
|
.SH NAME
|
|
template \- Templates a file out to a remote server.
|
|
." ------ DESCRIPTION
|
|
.SH DESCRIPTION
|
|
.PP
|
|
Templates are processed by the Jinja2 templating language (\fIhttp://jinja.pocoo.org/docs/\fR) - documentation on the template formatting can be found in the Template Designer Documentation (\fIhttp://jinja.pocoo.org/docs/templates/\fR).
|
|
." ------ OPTIONS
|
|
."
|
|
."
|
|
.SH OPTIONS
|
|
|
|
.IP dest
|
|
Location to render the template to on the remote machine.(required)
|
|
.IP src
|
|
Path of a Jinja2 formatted template on the local server. This can be a relative or absolute path.(required)
|
|
.IP backup
|
|
Create a backup file including the timestamp information so you can get the original file back if you somehow clobbered it incorrectly.
|
|
.IR Choices :
|
|
yes,no. (default: no)
|
|
.IP others
|
|
all arguments accepted by the \fIfile\fR module also work here."
|
|
."
|
|
." ------ NOTES
|
|
.SH NOTES
|
|
.PP
|
|
Since Ansible version 0.9, templates are loaded with \fCtrim_blocks=True\fR.
|
|
."
|
|
."
|
|
." ------ EXAMPLES
|
|
.SH EXAMPLES
|
|
.PP
|
|
.nf
|
|
template src=/mytemplates/foo.j2 dest=/etc/file.conf owner=bin group=wheel mode=0644
|
|
.fi
|
|
." ------- AUTHOR
|
|
.SH AUTHOR
|
|
Michael DeHaan
|
|
.SH SEE ALSO
|
|
.IR ansible (1),
|
|
.I http://ansible.github.com/modules.html#template |