本帖最后由 yun 于 2019-9-11 17:23 编辑
ansible是一个系列文章,我们会尽量以通俗易懂的方式总结ansible的相关知识点。 "ansible系列"中的每篇文章都建立在前文的基础之上,所以,请按照顺序阅读这些文章,否则有可能在阅读中遇到障碍。
在使用ansible的过程中,我们经常需要处理一些返回信息,而这些返回信息中,通常可能不是单独的一条返回信息,而是一个信息列表,如果我们想要循环的处理信息列表中的每一条信息,我们该怎么办呢?这样空口白话的描述有些费力,不如通过一些小示例,结合场景来描述。
假设,我的清单配置如下 - 10.1.1.60
- test70.zsythink.net ansible_host=10.1.1.70
- test71 anisble_host=10.1.1.71
-
- [testA]
- test60 ansible_host=10.1.1.60
- test61 ansible_host=10.1.1.61
-
- [testB]
- test70 ansible_host=10.1.1.70
-
- [test:children]
- testA
- testB
复制代码如果我想要获取到清单中所有未分组的主机的主机名,则可以执行如下命令 - # ansible test70 -m debug -a "msg={{groups.ungrouped}}"
- test70 | SUCCESS => {
- "changed": false,
- "msg": [
- "10.1.1.60",
- "test70.zsythink.net",
- "test71"
- ]
- }
复制代码从返回信息可以看出,一共有3个未分组主机,上例的返回信息中就不只有一条信息记录,如果我们想要获取到上述返回信息中的第二条信息,则可以使用如下方法 - # ansible test70 -m debug -a "msg={{groups.ungrouped[1]}}"
- test70 | SUCCESS => {
- "changed": false,
- "msg": "test70.zsythink.net"
- }
复制代码但是问题是,我们通常不能确定返回信息有几条,我们可能需要循环的处理返回信息中的每一条信息,那么怎么才能循环处理返回信息中的每一条信息呢?示例playbook如下 - ---
- - hosts: test70
- remote_user: root
- gather_facts: no
- tasks:
- - debug:
- msg: "{{item}}"
- with_items: "{{groups.ungrouped}}"
复制代码上例中,我们通过"{{groups.ungrouped}}"获取到了未分组的返回信息,并使用关键字"with_items"接收了返回信息,然后使用debug模块输出了名为"item"变量的变量值,聪明如你一定已经明白了,"with_items"关键字会把返回的列表信息自动处理,将每一条信息单独放在一个名为"item"的变量中,我们只要获取到名为"item"变量的变量值,即可循环的获取到列表中的每一条信息,所以,上例中返回信息中的每一条信息都会循环的被debug模块处理,执行上述playbook后结果如下 - TASK [debug] *********************************************
- ok: [test70] => (item=10.1.1.60) => {
- "changed": false,
- "item": "10.1.1.60",
- "msg": "10.1.1.60"
- }
- ok: [test70] => (item=test70.zsythink.net) => {
- "changed": false,
- "item": "test70.zsythink.net",
- "msg": "test70.zsythink.net"
- }
- ok: [test70] => (item=test71) => {
- "changed": false,
- "item": "test71",
- "msg": "test71"
- }
复制代码从执行playbook的结果可以看出,debug模块对每条信息都单独输出了一次,而不是三条信息同时一次输出,由于对应play是针对test70主机操作的,所以上例中debug模块的三次操作都是在test70主机上进行的,只不过debug模块只是输出信息,并不会对test70主机做出什么实际的改动而已,通过上述方法,就能够符合我们循环操作的要求了。
上例中,我们使用的是返回值中的信息,那么我们能不能自定义一个列表,然后循环使用列表中的值呢?必须能的,示例如下 - ---
- - hosts: test70
- remote_user: root
- gather_facts: no
- tasks:
- - debug:
- msg: "{{item}}"
- with_items:
- - 1
- - 2
- - 3
复制代码如上例所示,我们自定义了3个值,分别是1、2、3,debug模块会循环的输出这三个值。 或者我们换一种写法,如下写法与上述写法的效果完全相同。 - ---
- - hosts: test70
- remote_user: root
- gather_facts: no
- tasks:
- - debug:
- msg: "{{item}}"
- with_items: [ 1, 2, 3 ]
复制代码我们还能够自定义稍微复杂些的列表,示例如下 - ---
- - hosts: test70
- remote_user: root
- gather_facts: no
- tasks:
- - debug:
- msg: "{{item.test1}}"
- with_items:
- - { test1: a, test2: b }
- - { test1: c, test2: d }
复制代码上例中自定义列表中的每一个条目都是一个对象,我们可以通过对象的属性对应的"键",获取到对应的"值",如上例所示,第一个条目的test1键对应的值是a,第二个条目的test1键对应的值是c,所以执行上例playbook以后,"a"和"c"会被输出。
学会使用循环,能够让我们事半功倍。 比如,在没有学会使用循环之前,如果想要在同一主机中创建四个文件,那么你可能会编写如下playbook - ---
- - hosts: test70
- remote_user: root
- gather_facts: no
- tasks:
- - file:
- path: "/opt/a"
- state: touch
- - file:
- path: "/opt/b"
- state: touch
- - file:
- path: "/opt/c"
- state: touch
- - file:
- path: "/opt/d"
- state: touch
复制代码我们重复的书写了file模块4次,其实每次只是改变了file模块的path参数的值而已,如果使用循环,上例的playbook则可以改写成如下 - ---
- - hosts: test70
- remote_user: root
- gather_facts: no
- vars:
- dirs:
- - "/opt/a"
- - "/opt/b"
- - "/opt/c"
- - "/opt/d"
- tasks:
- - file:
- path: "{{item}}"
- state: touch
- with_items: "{{dirs}}"
复制代码正如上述示例所示,重复的操作越多,使用循环则越方便。
那么我们再来看一个小示例,这个示例与循环没有直接关系,但是可以引出我们要说的话题,示例playbook如下: - ---
- - hosts: test70
- gather_facts: no
- tasks:
- - shell: "ls /opt"
- register: returnvalue
- - debug:
- var: returnvalue
复制代码看到上例,你一定不会觉得陌生,在之前总结变量的文章中,我们已经总结过"register"的用法,我们可以通过"register"获取到模块执行后的"返回值"信息,如果你忘记了"register"的用法,请回顾前文,上例中,我们将shell模块执行后的返回值写入了名为"returnvalue"的变量中,然后使用debug模块输出了"returnvalue"变量的值,上述playbook执行后结果如下 - TASK [debug] ******************
- ok: [test70] => {
- "returnvalue": {
- "changed": true,
- "cmd": "ls /opt",
- "delta": "0:00:01.006690",
- "end": "2018-07-12 17:43:01.445936",
- "failed": false,
- "rc": 0,
- "start": "2018-07-12 17:43:00.439246",
- "stderr": "",
- "stderr_lines": [],
- "stdout": "rh",
- "stdout_lines": [
- "rh"
- ]
- }
- }
复制代码可以看到shell模块的返回值信息如上,但是,上例并没有借助循环重复调用shell模块,如果使用循环多次调用shell模块执行不同的命令,返回信息的格式还会和原来一样吗?我们来实验一下,我们将上例的playbook修改如下 - ---
- - hosts: test70
- gather_facts: no
- tasks:
- - shell: "{{item}}"
- with_items:
- - "ls /opt"
- - "ls /home"
- register: returnvalue
- - debug:
- var: returnvalue
复制代码如上例所示,我们使用循环重复调用了shell模块两次,分别执行了两条命令,然后将shell模块的返回值存放到了"returnvalue"变量中,最后使用debug模块输出了"returnvalue"变量的值,那么当我们使用循环时,返回值信息会和原来一样么?上例的playbook执行后debug模块的输出如下 细心如你一定发现了,当使用了循环以后,每次shell模块执行后的返回值都会放入一个名为"results"的序列中,其实,"results"也是一个返回值,当模块中使用了循环时,模块每次执行的返回值都会追加存放到"results"这个返回值中,所以,我们可以通过"results"关键字获取到每次模块执行后的返回值,示例如下 - ---
- - hosts: test70
- gather_facts: no
- tasks:
- - shell: "{{item}}"
- with_items:
- - "ls /opt"
- - "ls /home"
- register: returnvalue
- - debug:
- msg: "{{item.stdout}}"
- with_items: "{{returnvalue.results}}"
复制代码上例中,我们先使用循环重复的调用了shell模块,然后将shell模块每次执行后的返回值注册到了变量"returnvalue"中,之后,在使用debug模块时,通过返回值"results"获取到了之前每次执行shell模块的返回值(shell每次执行后的返回值已经被放入到item变量中),最后又通过返回值"stdout"获取到了每次shell模块执行后的标准输出,你可以执行一下上例的playbook,执行后,输出结果的msg关键字对应的值就是每次shell模块执行后的标准输出。 你可能还会看到有的朋友使用如下方法输出"{{returnvalue.results}}"列表中的信息 - ---
- - hosts: test70
- gather_facts: no
- tasks:
- - shell: "{{item}}"
- with_items:
- - "ls /opt"
- - "ls /home"
- register: returnvalue
- - debug:
- msg:
- "{% for i in returnvalue.results %}
- {{ i.stdout }}
- {% endfor %}"
复制代码你一定看出来了,上例使用了一个for循环遍历了" returnvalue.results"列表,上例中for循环的语法为jinja2语言中的for循环语法,jinja2是一种模板语言,jinja2是一个基于python的模板引擎,所以,在ansible中,我们可以使用jinja2编写模板文件,然后再根据模板文件来生成配置文件,jinja2中也有一些控制语句结构,比如for循环,上例中使用的就是jinja2语法中的for循环,如果你执行了上例的playbook,你会发现,debug模块只执行了一次,msg中对应的信息是所有shell模块执行后的stdout返回值,因为debug模块只是输出了经过jinja2的for循环处理过的信息而已,debug模块并没有因为for循环而被重复的调用。如果你对jinja2的语法不是很了解,不用在意,此处只是展示一个小示例,当我们总结模板的用法时,再去了解jinja2相应的使用方法也不迟,所以看不懂也不用纠结。
这篇文章就总结到这里,希望能够对你有所帮助~
|