ansible/docs/docsite/rst/user_guide/playbooks_templating.rst

.. _playbooks_templating:

Templating (Jinja2)
===================

As already referenced in the variables section, Ansible uses Jinja2 templating to enable dynamic expressions and access to variables.
Ansible greatly expands the number of filters and tests available, as well as adding a new plugin type: lookups.

Please note that all templating happens on the Ansible controller before the task is sent and executed on the target machine. This is done to minimize the requirements on the target (jinja2 is only required on the controller) and to be able to pass the minimal information needed for the task, so the target machine does not need a copy of all the data that the controller has access to.

.. contents:: Topics

.. toctree::
   :maxdepth: 2

   playbooks_filters
   playbooks_tests
   playbooks_lookups
   playbooks_python_version


.. seealso::

   :doc:`playbooks`
       An introduction to playbooks
   :doc:`playbooks_conditionals`
       Conditional statements in playbooks
   :doc:`playbooks_loops`
       Looping in playbooks
   :doc:`playbooks_reuse_roles`
       Playbook organization by roles
   :doc:`playbooks_best_practices`
       Best practices in playbooks
   `User Mailing List <https://groups.google.com/group/ansible-devel>`_
       Have a question?  Stop by the google group!
   `irc.freenode.net <http://irc.freenode.net>`_
       #ansible IRC chat channel
Updates variables docs: facts examples, headers, links, etc. (#47767) * refreshes ansible facts output and updates some references/headers 2018-10-30 15:37:34 +00:00			`.. _playbooks_templating:`

Doc fixes (#20353) * cleanup to reflect current builds * consolidate templating docs and minor rewording * new templating intro page * fixed warnings as per feedback * Update playbooks_filters.rst Edited for clarity. * Update playbooks_templating.rst Light edits 2017-01-18 02:55:03 +00:00			`Templating (Jinja2)`
			`===================`

			`As already referenced in the variables section, Ansible uses Jinja2 templating to enable dynamic expressions and access to variables.`
corrected which app adds plugins 2017-01-18 19:14:00 +00:00			`Ansible greatly expands the number of filters and tests available, as well as adding a new plugin type: lookups.`
Doc fixes (#20353) * cleanup to reflect current builds * consolidate templating docs and minor rewording * new templating intro page * fixed warnings as per feedback * Update playbooks_filters.rst Edited for clarity. * Update playbooks_templating.rst Light edits 2017-01-18 02:55:03 +00:00
			`Please note that all templating happens on the Ansible controller before the task is sent and executed on the target machine. This is done to minimize the requirements on the target (jinja2 is only required on the controller) and to be able to pass the minimal information needed for the task, so the target machine does not need a copy of all the data that the controller has access to.`

			`.. contents:: Topics`

			`.. toctree::`
			`:maxdepth: 2`

			`playbooks_filters`
			`playbooks_tests`
			`playbooks_lookups`
Add documentation of Jinja2 templating idioms that differ when run under Python3 Fixes #19514 2017-04-10 18:22:06 +00:00			`playbooks_python_version`
Doc fixes (#20353) * cleanup to reflect current builds * consolidate templating docs and minor rewording * new templating intro page * fixed warnings as per feedback * Update playbooks_filters.rst Edited for clarity. * Update playbooks_templating.rst Light edits 2017-01-18 02:55:03 +00:00

			`.. seealso::`

			:doc:`playbooks`
			`An introduction to playbooks`
			:doc:`playbooks_conditionals`
			`Conditional statements in playbooks`
			:doc:`playbooks_loops`
			`Looping in playbooks`
Imports and includes (#25399) Initial commit to split includes into static imports/dynamic includes This implements the new include/import syntax for Ansible 2.4: * include_{tasks,role,variables} = dynamic * import_{playbook,tasks,role} = static The old bare `include` will be considered deprecated, as will any use of the `static: {yes\|no}` option. This also adds docs for import/include and reorganizing the "Playbook Reuse" section of the documentation. 2017-06-06 21:39:48 +00:00			:doc:`playbooks_reuse_roles`
Doc fixes (#20353) * cleanup to reflect current builds * consolidate templating docs and minor rewording * new templating intro page * fixed warnings as per feedback * Update playbooks_filters.rst Edited for clarity. * Update playbooks_templating.rst Light edits 2017-01-18 02:55:03 +00:00			`Playbook organization by roles`
			:doc:`playbooks_best_practices`
			`Best practices in playbooks`
Prefer https:// links in the docs site All the changed urls are availible by way of https://. Most of them already redirect. 2018-07-21 13:48:47 +00:00			`User Mailing List <https://groups.google.com/group/ansible-devel>`_
Doc fixes (#20353) * cleanup to reflect current builds * consolidate templating docs and minor rewording * new templating intro page * fixed warnings as per feedback * Update playbooks_filters.rst Edited for clarity. * Update playbooks_templating.rst Light edits 2017-01-18 02:55:03 +00:00			`Have a question? Stop by the google group!`
			`irc.freenode.net <http://irc.freenode.net>`_
			`#ansible IRC chat channel`