Linux jinja2模板的使用
本章实验都在/home/lduan/demo4下操作,先把demo4目录创建出来并把ansible.cfg和hosts拷贝进去,命令如下。
Session lifetime based on X11 requested, but X11 initialization failed.
[blab@rh1 ~]$ mkdir demo4
[blab@rh1 ~]$ cp ansible.cfg hosts demo4/
[blab@rh1 ~]$ cd demo4/
[blab@rh1 demo4]$
用copy拷贝一个文件到db主机组。
有一个文件aa.txt,内容如下。
[blab@rh1 demo4]$ cat aa.txt
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的 IP 地址是: {{ansible_default_ipv4.address}}
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
这个文件中包含一个 fact变量 ansible_default_ipv4.address。
写一个 playbook,内容如下。
[blab@rh1 demo4]$ cat 1.yaml
---
- hosts: db
tasks:
- name: 拷贝一个文件到远端主机
copy: src=aa.txt dest=/opt/aa.txt
运行此playbook,命令如下。
[blab@rh1 demo4]$ ansible-playbook 1.yaml
PLAY [db] *********************************************************************************************
TASK [Gathering Facts] ********************************************************************************
ok: [rh2]
ok: [rh3]
TASK [拷贝一个文件到远端主机] ************************************************************************************
changed: [rh3]
changed: [rh2]
PLAY RECAP ********************************************************************************************
rh2 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
rh3 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
现在已经把本地的aa.,txt拷贝到rh2和 rh3的/opt目录中了。下面查看这两台主机上 /opt/aa.txt的内容,命令如下。
[blab@rh1 demo4]$ ansible db -m shell -a "cat /opt/aa.txt"
rh3 | CHANGED | rc=0 >>
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的 IP 地址是: {{ansible_default_ipv4.address}}
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
rh2 | CHANGED | rc=0 >>
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的 IP 地址是: {{ansible_default_ipv4.address}}
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
可以看到,当用copy铂贝一个文件到远端机器时,如果这个文件中有变量,铂贝过去的文件中的变量并不会变成具体的值。
如果希望文件考别过去之后,文件中的变量变成具体的值,那么就不能使用copy模块,而是要使用template模块了。
修改1.yaml的内容如下。
[blab@rh1 demo4]$ cat 1.yaml
---
- hosts: db
tasks:
- name: 拷贝一个文件到远端主机
template: src=aa.txt dest=/opt/aa.txt
与刚才相比,只是把copy换成了template。template模块的用法与copy模块一致,所以这里选项并没有变。运行此 playbook,命令如下。
[blab@rh1 demo4]$ ansible-playbook 1.yaml
PLAY [db] *********************************************************************************************
TASK [Gathering Facts] ********************************************************************************
ok: [rh3]
ok: [rh2]
TASK [拷贝一个文件到远端主机] ************************************************************************************
changed: [rh3]
changed: [rh2]
PLAY RECAP ********************************************************************************************
rh2 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
rh3 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
再次查看两台主机上/opt/aa.txt的内容,命令如下。
[blab@rh1 demo4]$ ansible db -m shell -a "cat /opt/aa.txt"
rh3 | CHANGED | rc=0 >>
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的 IP 地址是: 192.168.25.172
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
rh2 | CHANGED | rc=0 >>
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的 IP 地址是: 192.168.25.171
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
可以看到,通过template铂贝含有变量的文件时,拷贝到远端机器之后,文件中的变量会变成具体的值。
这个通过template拷贝的、含有变量的文件我们称为jinja2模板,jinja2模板文件的后缀一般使用j2,这不是必需的,但是建议使用j2作为后缀。
所以,需要修改aa.txt的文件为aa.j2
[blab@rh1 demo4]$ mv aa.txt aa.j2
同时修改1.yaml中对应的内容,如下所示。
[blab@rh1 demo4]$ cat 1.yaml
---
- hosts: db
tasks:
- name: 拷贝一个文件到远端主机
template: src=aa.j2 dest=/opt/aa.txt
这里如果jinja2模板文件没有写路径,例如,例子中 src=aa.j2的aa.j2没有写路径,则优先到当前目录的templates 中找aa.j2,如果没有,则到当前目录中找aa.j2。
验证,命令如下。
[blab@rh1 demo4]$ mkdir templates
在templates目录中创建aa.j2,内容如下。
[blab@rh1 templates]$ cat aa.j2
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的 IP 地址是: {{ansibe_fqdn}}
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
这样我们就有两个aa.j2了,还有一个是当前目录下的aa.j2,如下所示。
[blab@rh1 demo4]$ cat aa.j2
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的 IP 地址是: {{ansible_default_ipv4.address}}
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
再次运行此playbook,命令如下。
[blab@rh1 demo4]$ ansible db -m shell -a "cat /opt/aa.txt"
rh3 | CHANGED | rc=0 >>
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的主机名是: rh3
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
rh2 | CHANGED | rc=0 >>
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
| 我的主机名是: rh2
+‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐‐+
这里可以看到显示的主机名,所以是 templates目录中的aa.j2生效了。
if判断
在jinja2模板文件中,我们也是可以使用if判断语句的,语法格式如下。
{% if 判断1 %}
内容1
{% elif 判断2 %}
内容2
...多个elif...
{% else %}
内容3
{% endif %}
注意:
(1)“%”两边有没有空格都可以,不过所有的“%”前后空格要保持一致,即要有都有,要没有都没有。
(2)if和elif中的内容如果太长了,可以另起一行写。
如果判断1成立,则打印内容1,后面的条件不再判断,直接跳转到endif后面的内容;如果判断1不成立,则执行elif后面的判断2,如果成立则打印内容2,后面的条件不再判断,直接跳转到endif后面的内容。以此类推,如果所有的f和elif都不成立,则打印else中的内容
(3)elif和 else不是必需的。
写一个 jinja2模板文件,内容如下。
[blab@rh1 templates]$ cat bb.j2
111111
{% if ansible_fqdn=="rh2" %}
{{ansible_fqdn}}
{% else %}
aaaa
{% endif %}
33333
这里jinja2模板所生成的文件一共会产生3行内容,第一行的1111和第三行的3333是必打印出来的,第二行的内容具体是什么要看情况。如果在rh2上执行则显示主机名,如果在其他机器上执行则显示aaaa。
写一个playbook,内容如下。
[blab@rh1 demo4]$ cat 2.yaml
---
- hosts: db
tasks:
- name: 拷贝一个文件
template: src=bb.j2 dest=/opt/bb.conf
这里是把templates/bb.j2拷贝到两台机器的/opt中并命名为bb.conf。运行此
playbook,命令如下。
[blab@rh1 demo4]$ ansible-playbook 2.yaml
PLAY [db] *********************************************************************************************
TASK [Gathering Facts] ********************************************************************************
ok: [rh2]
ok: [rh3]
TASK [拷贝一个文件] *****************************************************************************************
changed: [rh3]
changed: [rh2]
PLAY RECAP ********************************************************************************************
rh2 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
rh3 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
查看两台机器上/opt/bb.conf的内容,命令如下。
[blab@rh1 demo4]$ ansible db -m shell -a "cat /opt/bb.conf"
rh3 | CHANGED | rc=0 >>
111111
aaaa
33333
rh2 | CHANGED | rc=0 >>
111111
rh2
33333
可以看到,server2的/opt/bb.conf的第二行显示的是主机名,server3的/opt/bb.conf的第二行显示的是 aaaa。
在if和 elif后面是可以写多个判断的,用or或and作为连接符,语法如下。
判断1 or 判断11:判断1和判断11只要有一个成立就算成立,只有全部不成立才算不成立。
判断1 and 判断11:判断1和判断11只有全部成立才算成立,只要有一个不成立就算不成立。
查看下面的 jinja2模板文件。
[blab@rh1 demo4]$ cat templates/cc.j2
11111
{% if ansible_fqdn="rh2"
and
ansible_distribution_major_version=="7" %}
{{ansible_fqdn}}
{% else %}
aaaaa
{% endif %}
33333
这里jinja2模板会打印3行内容,第一行和第三行的内容是固定的,为1111和3333。第二行的内容是什么,要看是否满足条件,这里判断被管理主机名为rh2及系统主版本号为7,二者都要满足,第二行才会显示主机名,否则显示 aaaa。需要注意的是,这里if判断语句太长,特意写成了3行也是没问题的。
写一个playbook,内容如下。
[blab@rh1 demo4]$ cat 3.yaml
---
- hosts: db
tasks:
- name: 拷贝一个文件
template: src=cc.j2 dest=/opt/cc.conf
运行此playbook。命令如下。
[blab@rh1 demo4]$ ansible-playbook 3.yaml
PLAY [db] *********************************************************************************************
TASK [Gathering Facts] ********************************************************************************
ok: [rh3]
ok: [rh2]
TASK [拷贝一个文件] *****************************************************************************************
changed: [rh2]
changed: [rh3]
PLAY RECAP ********************************************************************************************
rh2 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
rh3 : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
查看两台机器上/opt/cc.conf的内容,命令如下。
[blab@rh1 demo4]$ ansible db -m shell -a "cat /opt/cc.conf"
rh3 | CHANGED | rc=0 >>
1111
aaaa
3333
rh2 | CHANGED | rc=0 >>
1111
aaaa
3333