Ansible 小手册系列 十三（Jinja2）

用于playbook中的jinja 2过滤器

---

更改数据格式，其结果是字符串

{{  some_variable | to_json  }} 
{{  some_variable | to_yaml  }}

对于人类可读的输出

{{  some_variable | to_nice_json  }} 
{{  some_variable | to_nice_yaml  }}

还可以增加参数( new in 2.2)

{{ some_variable | to_nice_json(indent=2) }}
{{ some_variable | to_nice_yaml(indent=8) }}

从json字符串读取，其结果为json类型

{{ some_variable | from_json }}

从yaml字符串读取，其结果为yaml类型

{{ some_variable | from_yaml }}

常用示例：

tasks:
  - shell: cat /some/path/to/file.json
    register: result
- set_fact: myvar="{{ result.stdout | from_json }}"

强制定义变量

如果变量未定义，则来自ansible和ansible.cfg的默认行为为失败，但您可以将其关闭。

{{ variable | mandatory }}

使用未定义的变量

{{ result.cmd|default(5) }}

result.cmd 如果没由定义的话，则其默认值为5

省略参数

- name: touch files with an optional mode
  file: dest={{item.path}} state=touch mode={{item.mode|default(omit)}}
  with_items:
    - path: /tmp/foo
    - path: /tmp/bar - path: /tmp/baz mode: "0444" 

对于列表中的前两个文件，默认mode将由系统的umask确定，因为mode=parameter 不会发送到文件模块，而最后得文件将接收mode=0444选项。

列表过滤

取最小的值

{{ list1 | min }}

取最大的值

{{ [3, 4, 2] | max }}

数据集过滤

对列表唯一过滤

{{ list1 | unique }}

对两个列表去重合并

{{ list1 | union(list2) }}

对两个列表做交集

{{ list1 | intersect(list2) }}

找到两个列表差异部分(在list1 不在list2 的差异)

{{ list1 | difference(list2) }}

找到两个列表都互相不在对方列表的部分

{{ list1 | symmetric_difference(list2) }}

随机数过滤

从列表中随机获取元素

{{ ['a','b','c','d','e','f']|random }} 

从0-59 的整数中随机获取一个数

{{ 59 |random}}

从0-100 中随机获取能被10 整除的数（可以理解为0 10 20 30 40 50 ...100 的随机数）

{{ 100 |random(step=10) }}

从0-100 中随机获取1 开始步长为10 的数（可以理解为1 11 21 31 41...91 的随机数）

{{ 100 |random(1, 10) }}
{{ 100 |random(start=1, step=10) }} 

合并散列

{{ {'a':1, 'b':2}|combine({'b':3}) }}

结果

{'a':1, 'b':3}

支持递归合并

{{ {'a':{'foo':1, 'bar':2}, 'b':2}|combine({'a':{'bar':3, 'baz':4}}, recursive=True) }} 

结果

{'a':{'foo':1, 'bar':3, 'baz':4}, 'b':2} 

提取过滤器

{{ groups['x']|map('extract', hostvars, 'ec2_ip_address')|list }} 

这需要组“x”中的主机列表，在hostvars中查找它们，然后查找结果中的ec2_ip_address。 最终结果是组“x”中的主机的IP地址列表。

注释过滤器

{{ "Plain style (default)" | comment }}

输出

#
# Plain style (default)
#

输出各种语言的注释风格

{{ "C style" | comment('c') }}
{{ "C block style" | comment('cblock') }}
{{ "Erlang style" | comment('erlang') }} {{ "XML style" | comment('xml') }} 

还可以自定义

{{ "Custom style" | comment('plain', prefix='#######\n#', postfix='#\n#######\n   ###\n    #') }}

正则匹配

when: ansible_os_family | match("Red[Hh]at" )
when: url | search("/users/.*/resources/.*") 

** 其他的常用过滤**

为shell增加双引号

- shell: echo {{ string_value | quote }}

根据True，False来返回值

{{ ('name' == 'John') | ternary('Mr','Ms') }}

列表转换字符

{{ list | join(" ") }}

获取路径的文件名

{{ path | basename }}

windows平台下获取路径的文件名

{{ path | win_basename }}

获取路径中的目录

{{ path | dirname }}

获取软连接的真实路径

{{ path | realpath }}

获取文件名的名称和扩展名

{{ path | splitext }}

base64编码

{{ encoded | b64decode }}
{{ decoded | b64encode }}

从字符串创建UUID（1.9版中的新功能）

{{ hostname | to_uuid }}

将转换为布尔类型，如"True" 字符串转换为True

- debug: msg=test
  when: some_string_value | bool

查看变量的python类型

{{ myvar | type }}

随机列表过滤

给已存在的列表随机排序

{{ ['a','b','c']|shuffle }} => ['c','a','b'] {{ ['a','b','c']|shuffle }} => ['b','c','a'] 

数学

获取对数

{{ myvar | log }}
{{ myvar | log(10) }}

获取n次幂

{{ myvar | pow(2) }}
{{ myvar | pow(5) }} 

获取平方根

{{ myvar | root }}
{{ myvar | root(5) }}

ip地址过滤

字符串转ip地址

{{ myvar | ipaddr }}

字符串转ip协议地址

{{ myvar | ipv4 }}
{{ myvar | ipv6 }}

从cidr中获取地址信息

{{ '192.0.2.1/24' | ipaddr('address') }}

哈希过滤器

获取字符串得hash值

{{ 'test1'|hash('sha1') }}
{{ 'test1'|hash('md5') }} 

获取字符串校验和

{{ 'test2'|checksum }}

获取sha512密码哈希

{{ 'passwordsaresecret'|password_hash('sha512') }}
{{ 'secretpassword'|password_hash('sha256', 'mysecretsalt') }} 

playbook中的测试

---

除了过滤器，所谓的“测试”也是可用的。测试可以用于对照普通表达式测试一个变量。 要测试一个变量或表达式，你要在变量后加上一个 is 以及测试的名称。例如，要得出 一个值是否定义过，你可以用 name is defined ，这会根据 name 是否定义返回 true 或 false 。
测试也可以接受参数。如果测试只接受一个参数，你可以省去括号来分组它们。例如， 下面的两个表达式做同样的事情:

{% if loop.index is divisibleby 3 %}
{% if loop.index is divisibleby(3) %} 

测试字符串

vars:
  url: "http://example.com/users/foo/resources/bar"

tasks:
    - shell: "msg='matched pattern 1'"
      when: url | match("http://example.com/users/.*/resources/.*")

    - debug: "msg='matched pattern 2'"
      when: url | search("/users/.*/resources/.*") - debug: "msg='matched pattern 3'" when: url | search("/users/") 

'match'需要在字符串中完全匹配，而'search'只需要匹配字符串的子集。匹配成功返回True，任务则执行。

版本比较

检查ansible_distribution_version版本是否大于或等于'12 .04'，条件成立返回True。

{{ ansible_distribution_version | version_compare('12.04', '>=') }}

进行严格的版本检查

{{ sample_version_var | version_compare('1.0', operator='lt', strict=True) }}

可接受的运算符

<, lt, <=, le, >, gt, >=, ge, ==, =, eq, !=, <>, ne

包含测试
测试一个列表是否包含另一个列表。

vars:
    a: [1,2,3,4,5] b: [2,3] tasks: - debug: msg="A includes B" when: a|issuperset(b) - debug: msg="B is included in A" when: b|issubset(a) 

路径测试

- debug: msg="path is a directory"
  when: mypath|is_dir - debug: msg="path is a file" when: mypath|is_file - debug: msg="path is a symlink" when: mypath|is_link - debug: msg="path already exists" when: mypath|exists - debug: msg="path is {{ (mypath|is_abs)|ternary('absolute','relative')}}" - debug: msg="path is the same file as path2" when: mypath|samefile(path2) - debug: msg="path is a mount" when: mypath|ismount 

任务测试

以下playbook是检查任务状态的测试。

tasks:
- shell: /usr/bin/foo
    register: result
    ignore_errors: True - debug: msg="it failed" when: result|failed - debug: msg="it changed" when: result|changed - debug: msg="it succeeded in Ansible >= 2.1" when: result|succeeded - debug: msg="it succeeded" when: result|success - debug: msg="it was skipped" when: result|skipped 

用于 jinja2 模版中的一些语法

---

变量

变量可以通过 过滤器 修改。过滤器与变量用管道符号（ | ）分割，并且也 可以用圆括号传递可选参数。多个过滤器可以链式调用，前一个过滤器的输出会被作为 后一个过滤器的输入。

下面2种方式效果是一样的

{{ foo.bar }}
{{ foo['bar'] }}

如果变量或属性不存在，会返回一个未定义值。

** 注释**

要把模板中一行的部分注释掉，默认使用 {# ... #} 注释语法。

转义

简单的使用单引号进行转义
对于较大的段落，使用raw进行转义

{% raw %}
    <ul>
    {% for item in seq %}
        <li>{{ item }}</li> {% endfor %} </ul> {% endraw %} 

包含 > 、 < 、 & 或 " 字符的变量，必须要手动转义

 {{ user.username|e }} 

控制结构

控制结构指的是所有的那些可以控制程序流的东西 —— 条件（比如 if/elif/ekse ）、 for 循环、以及宏和块之类的东西。控制结构在默认语法中以 {% .. %} 块的形式 出现。

For

遍历序列

{% for user in users %}
  <li>{{ user.username|e }}</li>
{% endfor %}

迭代字典

{% for key, value in my_dict.iteritems() %}
    <dt>{{ key|e }}</dt>
    <dd>{{ value|e }}</dd> {% endfor %} 

循环 10 次迭代之后会终止处理

{% for user in users %}
    {%- if loop.index >= 10 %}{% break %}{% endif %} {%- endfor %} {% for user in users if loop.index <= 10 %} {{ loop.index }} {%- endfor %} 

注：使用break, 需要开启轮询控制. 具体是在ansible.cfg的jinja2_extensions变量加上jinja2.ext.loopcontrols.

在一个 for 循环块中你可以访问这些特殊的变量:

变量	描述
loop.index	当前循环迭代的次数（从 1 开始）
loop.index0	当前循环迭代的次数（从 0 开始）
loop.revindex	到循环结束需要迭代的次数（从 1 开始）
loop.revindex0	到循环结束需要迭代的次数（从 0 开始）
loop.first	如果是第一次迭代，为 True 。
loop.last	如果是最后一次迭代，为 True 。
loop.length	序列中的项目数。
loop.cycle	在一串序列间期取值的辅助函数。见下面的解释。

if 语句

Jinja 中的 if 语句可比 Python 中的 if 语句。

{% if kenny.sick %}
    Kenny is sick.
{% elif kenny.dead %}
    You killed Kenny!  You bastard!!!
{% else %} Kenny looks okay --- so far {% endif %} 

** 过滤器**

过滤器段允许你在一块模板数据上应用常规 Jinja2 过滤器。只需要把代码用 filter 节包裹起来:

{% filter upper %}
    This text becomes uppercase
{% endfilter %}

赋值

在代码块中，你也可以为变量赋值。在顶层的（块、宏、循环之外）赋值是可导出的，即 可以从别的模板中导入。

赋值使用 set 标签，并且可以为多个变量赋值:

{% set navigation = [('index.html', 'Index'), ('about.html', 'About')] %} {% set key, value = call_something() %} 

** 表达式**

{% ... %} 用于执行诸如 for 循环 或赋值的语句
{{ ... }} 把表达式的结果打印到模板上

if 表达式
一般的语法是
<do something> if <something is true> else <do something else>
例如：

{{ '[%s]' % page.title if page.title is defined else 'undefined' }} 

字面量

表达式最简单的形式就是字面量。字面量表示诸如字符串和数值的 Python 对象。下面 的字面量是可用的:

字面量	说明
"Hello World"	双引号或单引号中间的一切都是字符串。无论何时你需要在模板中使用一个字 符串（比如函数调用、过滤器或只是包含或继承一个模板的参数），它们都是 有用的。
42/42.23	直接写下数值就可以创建整数和浮点数。如果有小数点，则为浮点数，否则为 整数。记住在 Python 里， 42 和 42.0 是不一样的。
['list','of','objects']	一对中括号括起来的东西是一个列表。列表用于存储和迭代序列化的数据。
('tuple','of','values')	元组与列表类似，只是你不能修改元组。如果元组中只有一个项，你需要以逗号 结尾它。元组通常用于表示两个或更多元素的项。更多细节见上面的例子。
{dict':'of','key':'and','value':'pairs'}	Python 中的字典是一种关联键和值的结构。键必须是唯一的，并且键必须只有一个 值。字典在模板中很少使用，罕用于诸如 xmlattr() 过滤器之类。
true/false	true 永远是 true ，而 false 始终是 false 。

特殊常量 true 、 false 和 none 实际上是小写的。因为这在过去会导致 混淆，过去 True扩展为一个被认为是 false 的未定义的变量。所有的这三个 常量也可以被写成首字母大写（ True 、 False 和 None ）。尽管如此， 为了一致性（所有的 Jinja 标识符是小写的），你应该使用小写的版本。

算术

Jinja 允许你用计算值。这在模板中很少用到，但是为了完整性允许其存在。支持下面的 运算符:

运算符	说明
+	把两个对象加到一起。通常对象是素质，但是如果两者是字符串或列表，你可以用这 种方式来衔接它们。无论如何这不是首选的连接字符串的方式！连接字符串见 ~ 运算符。 {{ 1 + 1 }} 等于 2 。
-	用第一个数减去第二个数。 {{ 3 - 2 }} 等于 1 。
/	对两个数做除法。返回值会是一个浮点数。 {{ 1 / 2 }} 等于 {{ 0.5 }} 。
//	对两个数做除法，返回整数商。 {{ 20 // 7 }} 等于 2 。
%	计算整数除法的余数。 {{ 11 % 7 }} 等于 4 。
*	用右边的数乘左边的操作数。 {{ 2 * 2 }} 会返回 4 。也可以用于重 复一个字符串多次。 {{ ‘=’ * 80 }} 会打印 80 个等号的横条。
**	取左操作数的右操作数次幂。 {{ 2**3 }} 会返回 8 。

比较

比较符	说明
==	比较两个对象是否相等。
!=	比较两个对象是否不等。
>	如果左边大于右边，返回 true 。
>=	如果左边大于等于右边，返回 true 。
<	如果左边小于右边，返回 true 。
<=	如果左边小于等于右边，返回 true 。

逻辑

对于 if 语句，在 for 过滤或 if 表达式中，它可以用于联合多个表达式:

逻辑符	说明
and	如果左操作数和右操作数同为真，返回 true 。
or	如果左操作数和右操作数有一个为真，返回 true 。
not	对一个表达式取反（见下）。
(expr)	表达式组。

is 和 in 运算符同样支持使用中缀记法: foo is not bar 和 foo not in bar 而不是 not foois bar 和 not foo in bar 。所有的 其它表达式需要前缀记法 not (foo and bar) 。

其它运算符

下面的运算符非常有用，但不适用于其它的两个分类:

运算符	说明
in	运行序列/映射包含检查。如果左操作数包含于右操作数，返回 true 。比如 {{ 1 in[1,2,3] }} 会返回 true 。
is	运行一个 测试 。
		应用一个 过滤器 。
~	把所有的操作数转换为字符串，并且连接它们。 {{ "Hello " ~ name ~ "!" }} 会返回（假设 name 值为 ''John' ） Hello John! 。
()	调用一个可调用量:{{ post.render() }} 。在圆括号中，你可以像在 python 中一样使用位置参数和关键字参数: {{ post.render(user, full=true) }} 。
. / []	获取一个对象的属性。

---

 

转载于:https://www.cnblogs.com/wanstack/p/8650687.html