In this example an ansible playbook has some variables defined. These variables are then rendered by Jinja.
The jinja template file here is jinjafile.j2 that gets saved after the rendering to the text file /tmp/ansible.all
The Jinja2 template file here looks clumsy. but please note that the multiline comment in Jinja2 is as {# .... #}. These are used in order as here in this template to inline explain the Jinja syntax.
Once the playbook is in place and the jinja template file with the name of jinjafile.j2 with the contents as in the mention, you can run the playbook and then see the contents of the rendered file /tnp/ansible.all
The Ansible playbook looks like
---
- name: JinjAs
hosts: localhost
vars:
foo: { "bar": 200, "abc": 1000, "sujit": 20000 }
list1: [ 1, 2, 3 ]
list2: [ 3, 4, 5 ]
list3: { "x": "a", "y": "b" }
production:
- { name: "server1", ip: "1.1.1.1" }
- { name: "server2", ip: "2.2.2.2" }
tasks:
- name: jinja render save to a file
template: src=jinjafile.j2 dest=/tmp/ansible.all force=true
Please note that the actual JINJA syntax is highlighted in Blue and the remaining are the explanations of the syntax exampe.
The corresponding Jinja2 template file looks like
{#
## Select a random output from the list
## for selection of a random value from the list ["a", "b", "c"]
## the jinja syntax for the same is
##{{[ "a", "b", "c" ] | random }}
##
## The result is "b"
##
{{[ "a", "b", "c" ] | random }}
{#
## print the entire list here list1 is a list variable as list1 = [ 1, 2, 3 ]
## ## the jinja syntax for the same is
##
##{{ list1 }}
##
## The result is [1, 2, 3]
##
#}
{{ list1 }}
{#
## print each of the elements in a simple list
## here the list given is as list1 = [ 1, 2, 3 ]
## ## the jinja syntax for the same is
##
#}
{#
##{% for item in list1 %}
##{{ item }}
##{% endfor %}
##
## The result is
1
2
3
##
#}
{% for item in list1 %}
{{ item }}
{% endfor %}
{#
## printing of each of the element of a simple list variable where list1 is a variable like list1 = [ 1, 2, 3 ]
## This will union the 2 lists
## to union 2 lists where list1 = [ 1, 2, 3] and list2 = [ 3, 4, 5 ]
## the jinja syntax for the same is
##
##
##{{ list1 | union(list2) }}
## The result is [1, 2, 3, 4, 5]
##
#}
{{ list1 | union(list2) }}
{#
## This will show the length of the list
## This shows the length of the list list1 where list1 = [ 1, 2, 3 ]
## the jinja syntax for the same is
##
##
##{{ list1 | length }}
## The result is 3
##
#}
{{ list1 | length }}
{#
## This is to extract the elements at the list indexes of 0 and 1 from the list list11 where list1 = [ 1, 2, 3 ]
## extraction of the list index elements at the index of 0 and 1 from list list1 = [ 1, 2, 3 ]
## the jinja syntax for the same is
##
##
##{{ [0,2] | map('extract',list1)| list }}
## The result is [1, 3]
##
#}
{{ [0,2] | map('extract',list1)| list }}
{#
## This is to extract the values of the keys 'x' and 'y' from the dictionary { "x": 22 , "y" 44 }
## the jinja syntax for the same is
##
##{{ ['x', 'y'] | map('extract', { 'x': 22, 'y': 44 }) | list }}
##
## The result is [22, 44]
##
#}
{{ ['x', 'y'] | map('extract', { 'x': 22, 'y': 44 }) | list }}
{#
## This is again an example to know the number of elements but this time the object is a dict where
## the dict foo is as foo: { "bar": 200, "abc": 1000, "sujit": 20000 }
##
## ## the jinja syntax for the same is
##
##The lengh of the variable or the number of elements in the variable foo is
##{{ foo | length }}
##
##
## The result is 3
##
#}
{{ foo | length }}
{#
## for the dict variable foo where foo is foo: { "bar": 200, "abc": 1000, "sujit": 20000 }
## this prints each of the key and the value pairs iterating over all the elements of the dict
## notice the use of 'iteritems' here
##
## ## the jinja syntax for the same is
##
##
##
##{% for key, value in foo.iteritems() %}
##{{ key }} : "{{ value }}"
##{% endfor %}
##
##
## The result is
##
sujit : "20000"
abc : "1000"
bar : "200"
#}
{% for key, value in foo.iteritems() %}
{{ key }} : "{{ value }}"
{% endfor %}
{#
## for the variable foo which is a dict as foo: { "bar": 200, "abc": 1000, "sujit": 20000 }
## with the multiple elements
## this prints the value of the element having key as "bar"
## ## the jinja syntax for the same is
##
##
##{{ foo.bar }}
##
## The result is 200
##
##
##
#}
{{ foo.bar }}
{#
## this is the same as the example previous
##
##
## the jinja syntax for the same is
##
##{{ foo['bar'] }}
##
##
## The result is 200
##
#}
{{ foo['bar'] }}
{#
## This is for the example of evaluating the value of foo.bar is equal to 100 or not where foo is a dict as foo: { "bar": 200, "abc": 1000, "sujit": 20000 }
## the jinja syntax for the same is
##
##{% if foo.bar == 100 %}
##value is 100
##{% else %}
##value is not 100
##{% endif %}
##
## The result is "value is not 100"
##
#}
{% if foo.bar == 100 %}
value is 100
{% else %}
value is not 100
{% endif %}
{#
## See the length of or the list variable production where each of the entity in the variable production is a dict in itself
## Here the production variable looks like below.
## the same "production" variable has also been used in the subsequent examples
## production:
## - { name: "server1", ip: "1.1.1.1" }
## - { name: "server2", ip: "2.2.2.2" }
## the jinja syntax for the same is
##
##
##{{ production | length }}
##
##
## The result is 2
##
#}
{{ production | length }}
{#
## for the production variable above that is a list of dictionaries, the list shows the items of the list
## The result will be a list of dictionaries
##
##
## the jinja syntax for the same is
##
##
##{{ production | list }}
##
## The result is [{u'ip': u'1.1.1.1', u'name': u'server1'}, {u'ip': u'2.2.2.2', u'name': u'server2'}]
##
#}
{{ production | list }}
{#
## also the way to iterate through the elements of the variable production as production is a list of dicts
##
## the jinja syntax for the same is
##
##{% for item in production %}
## {{ item }}
##{% endfor %}
##
## The result is
{u'ip': u'1.1.1.1', u'name': u'server1'}
{u'ip': u'2.2.2.2', u'name': u'server2'}
##
#}
{% for item in production %}
{{ item }}
{% endfor %}
{#
## for the list of dictionaries values variable production this iterates to each dict element
## then this iterates through each of the elements in the dict and prints the key value pairs.
##
##
## the jinja syntax for the same is
##
##{% for item in production|list %}
##{% for key, value in item.iteritems() %}
##{{key}}: "{{value}}"
##{% endfor %}
##{% endfor %}
##
## The result is
ip: "1.1.1.1"
name: "server1"
ip: "2.2.2.2"
name: "server2"
##
#}
{% for item in production|list %}
{% for key, value in item.iteritems() %}
{{key}}: "{{value}}"
{% endfor %}
{% endfor %}
