黑帽联盟

 找回密码
 会员注册
查看: 1179|回复: 0
打印 上一主题 下一主题

[基础服务] ansible笔记(36):include

[复制链接]
yun 黑帽联盟官方人员 

920

主题

37

听众

1364

积分

超级版主

Rank: 8Rank: 8

  • TA的每日心情
    奋斗
    2019-10-18 11:20
  • 签到天数: 678 天

    [LV.9]以坛为家II

    本帖最后由 yun 于 2019-9-11 17:16 编辑

    ansible是一个系列文章,我们会尽量以通俗易懂的方式总结ansible的相关知识点。
    ansible系列博文直达链接:ansible轻松入门系列
    "ansible系列"中的每篇文章都建立在前文的基础之上,所以,请按照顺序阅读这些文章,否则有可能在阅读中遇到障碍。


    在进行编程时,我们都会将可以重复利用的代码提取出来,将提取出的代码作为一个逻辑单元,这个逻辑单元通常被称为"函数"或者"方法","函数"可以让我们更加方便的、重复的调用一段代码,而且,如果需要更改这段代码的逻辑,只要更改函数本身即可,所有调用函数之处的逻辑都会随之改变,同时,函数还可以让程序的可读性变强,比如,主干程序中只有几行代码,这几行代码只是调用了对应的几个函数,我们通常通过函数名称,就能大概的推算出函数的功能,当我们阅读主干程序时,看到各个函数的名称之后,就能够大概推算出整个主干程序的作用和逻辑,如果不使用函数,而是将所有代码都写在主干程序文件中,那么只能一行一行的阅读所有代码以后,才能大概的了解主干程序的作用,所以综上所述,函数能为我们带来很多的方便之处。

    在ansible中,其实也有类似的功能,这种功能被称之为"include",通过include,我们可以在一个playbook中包含另一个文件,以便实现我们刚才所描述的效果,这篇文章我们就来了解一下"include"的用法。
    注意:ansible经过版本的迭代更新,"include"的使用方法也有所变化,此处我们先从比较原始的使用方法开始介绍"include",然后再介绍新的使用方式,原始的使用方式以及对应的关键字在之后的版本中可能会被弃用,所以官网推荐我们使用新的方式进行操作,但是此处我们仍然从原始的使用方式开始总结,以便你看到别人早期编写的playbook时,也能够理解其含义。

    先来看一个小示例,假设,我想要编写两个playbook,这两个playbook分别用于安装LAMP环境和LNMP环境,两个playbook的大致内容如下:
    1. # cat lamp.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - yum:
    8.       name: mysql
    9.       state: present
    10.   - yum:
    11.       name: php-fpm
    12.       state: present
    13.   - yum:
    14.       name: httpd
    15.       state: present

    16. # cat lnmp.yml
    17. ---
    18. - hosts: test70
    19.   remote_user: root
    20.   gather_facts: no
    21.   tasks:
    22.   - yum:
    23.       name: mysql
    24.       state: present
    25.   - yum:
    26.       name: php-fpm
    27.       state: present
    28.   - yum:
    29.       name: nginx
    30.       state: present
    复制代码
    你一定看出来了,无论在lamp.yml中还是在lnmp.yml中,安装mysql和php部分的任务完全相同的,所以,我们可以把这两个任务提取出来,作为一个逻辑单元,示例如下,我们把安装mysql和php部分的任务提取到install_MysqlAndPhp.yml文件中,文件内容如下:
    1. # cat install_MysqlAndPhp.yml
    2. - yum:
    3.     name: mysql
    4.     state: present
    5. - yum:
    6.     name: php-fpm
    7.     state: present
    复制代码
    如上例所示,两个task被提取到了install_MysqlAndPhp.yml文件中,当我们需要安装mysql和php-fpm时,只需要调用此yml文件即可,那么怎样调用这个文件呢?方法如下,我们只要把lamp.yml和lnmp.yml修改为如下模样即可:
    1. # cat lamp.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: install_MysqlAndPhp.yml
    8.   - yum:
    9.       name: httpd
    10.       state: present

    11. # cat lnmp.yml
    12. ---
    13. - hosts: test70
    14.   remote_user: root
    15.   gather_facts: no
    16.   tasks:
    17.   - include: install_MysqlAndPhp.yml
    18.   - yum:
    19.       name: nginx
    20.       state: present
    复制代码
    正如你所看到的,我们使用了include模块,引用了install_MysqlAndPhp.yml文件,当我们引用此文件时,install_MysqlAndPhp.yml文件中的tasks都会在被引用处执行,这就是include的用法,是不是很简单,没错,include模块可以指定一个文件,这个文件中的内容是一个任务列表(一个或多个任务),当使用include模块引用对应的文件时,文件中的任务会在被引用处执行,就好像写在被引用处一样。

    经过上述描述,你一定已经明白了怎样使用"include",上例中,是在tasks关键字中使用include引用了对应的任务列表,其实,在handlers关键字中,也可以使用include,在前文中我们总结过,handlers其实也是一种任务,只是这种任务有相应的触发条件而已(此处不再赘述),那么怎样在handlers关键字中使用include呢?示例如下
    1. # cat test_include.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - file:
    8.      path: /opt/ttt
    9.      state: touch
    10.     notify: test include handlers

    11.   handlers:
    12.   - name: test include handlers
    13.     include: include_handler.yml

    14. # cat include_handler.yml
    15. - debug:
    16.     msg: "task1 of handlers"
    17. - debug:
    18.     msg: "task2 of handlers"
    19. - debug:
    20.     msg: "task3 of handlers"
    复制代码
    如上例所示,当"test include handlers"被触发时,include_handler.yml中的任务将会执行

    在上述示例中,无论是在tasks中使用include,还是在handlers中使用include,都是引用了一个任务列表,其实,"include"不仅能够引用任务列表,还能够引用playbook,比如,在一个playbook中引用另一个playbook,示例如下:
    1. # cat lamp.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: install_MysqlAndPhp.yml
    8.   - yum:
    9.       name: httpd
    10.       state: present

    11. - include: lnmp.yml
    复制代码
    如上例所示,我们在lamp.yml的结尾引入了lnmp.yml,当我们在执行lamp.yml时,会先执行lamp相关的任务,然后再执行lnmp.yml中的任务。

    在使用"函数"或者"方法"时,可能会需要传入一些"参数",以便更加灵活的根据实际情况作出对应的处理,那么,include有没有相似的功能呢?答案是肯定的,示例如下:
    1. # cat test_include1.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: in.yml
    8.      test_var1=hello
    9.      test_var2=test

    10. # cat in.yml
    11. - debug:
    12.     msg: "{{ test_var1 }}"
    13. - debug:
    14.     msg: "{{ test_var2 }}"
    复制代码
    如上例所示,在in.yml文件中一共有两个debug任务,这两个任务分别需要两个变量,在in.yml中并未定义任何变量,而是在test_include1.yml中使用include模块引用in.yml时,传入了两个参数,这两个参数的名字与变量名相同,执行上例playbook,可以看到in.yml中的两个任务都正常输出了,这就是向include文件传参的方法,是不是很容易,除了上述方法,我们还能够使用vars关键字,以key: value变量的方式传入参数变量,示例如下:
    1.   tasks:
    2.   - include: in.yml
    3.     vars:
    4.      test_var1: hello
    5.      test_var2: test
    复制代码
    上述两种方式都可以传入参数变量,通过vars关键字也能够传入结构稍微复杂的变量数据,以便在包含的文件中使用,示例如下:
    1. # cat test_include1.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: in.yml
    8.     vars:
    9.      users:
    10.       bob:
    11.         gender: male
    12.       lucy:
    13.         gender: female
    14.          
    15. # cat in.yml
    16. - debug:
    17.     msg: "{{ item.key}} is {{ item.value.gender }}"
    18.   loop: "{{ users | dict2items }}"
    复制代码
    在前文 中,我们也总结过tags的使用方法,我们也可以针对某个include去打标签,示例如下:
    1. # cat test_include1.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: in1.yml
    8.     tags: t1
    9.   - include: in2.yml
    10.     tags: t2

    11. # cat in1.yml
    12. - debug:
    13.     msg: "task1 in in1.yml"
    14. - debug:
    15.     msg: "task2 in in1.yml"

    16. # cat in2.yml
    17. - debug:
    18.     msg: "task1 in in2.yml"
    19. - debug:
    20.     msg: "task2 in in2.yml"
    复制代码
    如上例所示,两个include分别对应两个tag,如果我们在执行test_include1.yml时,指定tag为t2,那么in2.yml中的所有任务将会被执行,执行效果如下:
    1. # ansible-playbook --tags=t2 test_include1.yml

    2. PLAY [test70] ************************************
    3. TASK [debug] ************************************
    4. ok: [test70] => {
    5.     "msg": "task1 in in2.yml"
    6. }

    7. TASK [debug] ************************************
    8. ok: [test70] => {
    9.     "msg": "task2 in in2.yml"
    10. }

    11. PLAY RECAP ************************************
    复制代码
    所以,tag是针对include文件中的所有任务生效的。

    经过上述描述 ,你一定已经猜到了,我们也可以对include添加条件判断,还可以对include进行循环操作,示例如下:
    1. # cat test_include1.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: in3.yml
    8.     when: 2 > 1
    9.   - include: in3.yml
    10.     loop:
    11.     - 1
    12.     - 2
    13.     - 3

    14. # cat in3.yml
    15. - debug:
    16.     msg: "task1 in in3.yml"
    17. - debug:
    18.     msg: "task2 in in3.yml"
    复制代码
    通过上例,你一定看明白了,如果我们想要循环的调用多个任务,则可以使用上例中的方法,将需要循环调用的多个任务写入到一个yml文件中,然后使用include调用这个yml文件,再配合loop进行循环即可。

    说到循环,我们再来看一个小例子
    1. # cat A.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: B.yml
    8.     loop:
    9.     - 1
    10.     - 2
    11.     - 3

    12. # cat B.yml
    13. - debug:
    14.     msg: "{{item}}--task1 in B.yml"
    15. - debug:
    16.     msg: "{{item}}--task2 in B.yml"
    复制代码
    如上例所示,我们在A.yml中include了B.yml,并且循环调用了B.yml中的两个任务,在B.yml中,我们输出了item的信息,上例playbook执行结果如下
    1. # ansible-playbook A.yml

    2. PLAY [test70] *************************************************

    3. TASK [include] *************************************************
    4. included: /testdir/ansible/B.yml for test70
    5. included: /testdir/ansible/B.yml for test70
    6. included: /testdir/ansible/B.yml for test70

    7. TASK [debug] *************************************************
    8. ok: [test70] => {
    9.     "msg": "1--task1 in B.yml"
    10. }

    11. TASK [debug] *************************************************
    12. ok: [test70] => {
    13.     "msg": "1--task2 in B.yml"
    14. }

    15. TASK [debug] *************************************************
    16. ok: [test70] => {
    17.     "msg": "2--task1 in B.yml"
    18. }

    19. TASK [debug] *************************************************
    20. ok: [test70] => {
    21.     "msg": "2--task2 in B.yml"
    22. }

    23. TASK [debug] *************************************************
    24. ok: [test70] => {
    25.     "msg": "3--task1 in B.yml"
    26. }

    27. TASK [debug] *************************************************
    28. ok: [test70] => {
    29.     "msg": "3--task2 in B.yml"
    30. }

    31. PLAY RECAP *************************************************
    32. test70                     : ok=9    changed=0    unreachable=0    failed=0
    复制代码
    如你所见,我们在B文件中输出了item的信息,而item的信息正是A文件中loop对应的列表,换句话说就是,内层文件中的任务使用的item其实是外层文件中的item。
    聪明如你,一定想到了一个问题,如果B文件中也有循环操作,当我们在B文件中输出item信息时,item信息是B文件中的item信息,还是A文件中的item信息呢?我们一起来试试看,示例如下
    1. # cat A.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: B.yml
    8.     loop:
    9.     - 1
    10.     - 2

    11. # cat B.yml
    12. - debug:
    13.     msg: "{{item}}--task in B.yml"
    14.   loop:
    15.   - a
    16.   - b
    17.   - c
    复制代码
    如上例所示,B.yml中循环调用了debug模块,而在A.yml中,又循环的调用了B.yml,当出现这种"双层循环"的情况时,B文件中的item信息到底是什么呢?上例playbook执行效果如下:
    1.png
    如上图所示,当出现上述"双层循环"的情况时,内层item的信息为B.yml中的loop列表,而不是A.yml中的loop列表,在这种情况下,如果想要在B文件中获取到A文件中的item信息,该怎么办呢?其实,上图中紫色的警告信息中,已经包含了我们想要的答案,没错,正如你所看到的,在上例的情况中,使用'loop_var选项'即可在B文件中获取到A文件中的item信息,看到'loop_var',有没有觉得很眼熟?眼熟就对了,在前一篇文章中,我们保留了一个loop_control选项没有介绍,这个选项就是'loop_var'选项,那么现在,我们就来介绍一下loop_control的loop_var选项,示例如下:
    1. # cat A.yml
    2. ---
    3. - hosts: test70
    4.   remote_user: root
    5.   gather_facts: no
    6.   tasks:
    7.   - include: B.yml
    8.     loop:
    9.     - 1
    10.     - 2
    11.     loop_control:
    12.       loop_var: outer_item

    13. # cat B.yml
    14. - debug:
    15.     msg: "{{outer_item}}--{{item}}--task in B.yml"
    16.   loop:
    17.   - a
    18.   - b
    19.   - c
    复制代码
    如上例所示,我们在A文件中循环调用了B文件,并且在循环时使用了loop_control的loop_var选项,我们将loop_var选项的值设置为"outer_item",这表示,我们将外层循环的item值存放在了"outer_item"变量中,在B文件中的debug任务中,同时输出了"outer_item"变量和"item"变量的值,执行A.yml,执行结果如下:
    1. # ansible-playbook A.yml

    2. PLAY [test70] *************************************************

    3. TASK [include] *************************************************
    4. included: /testdir/ansible/B.yml for test70
    5. included: /testdir/ansible/B.yml for test70

    6. TASK [debug] *************************************************
    7. ok: [test70] => (item=a) => {
    8.     "msg": "1--a--task in B.yml"
    9. }
    10. ok: [test70] => (item=b) => {
    11.     "msg": "1--b--task in B.yml"
    12. }
    13. ok: [test70] => (item=c) => {
    14.     "msg": "1--c--task in B.yml"
    15. }

    16. TASK [debug] *************************************************
    17. ok: [test70] => (item=a) => {
    18.     "msg": "2--a--task in B.yml"
    19. }
    20. ok: [test70] => (item=b) => {
    21.     "msg": "2--b--task in B.yml"
    22. }
    23. ok: [test70] => (item=c) => {
    24.     "msg": "2--c--task in B.yml"
    25. }

    26. PLAY RECAP *************************************************
    27. test70                     : ok=4    changed=0    unreachable=0    failed=0
    复制代码
    从执行结果可以看出,"outer_item"变量中的值正是外层循环中item的值,这就是loop_var选项的作用。
    当出现这种"双层循环"的情况时,则可以在外层循环中使用loop_var选项指定一个变量,这个变量可以用来代替外层循环中的item变量,以便在内层循环中获取到外层循环的item的值,从而避免了两层循环中"item"变量名的冲突,看到这里,你一定已经看明白了。

    这篇文章就先总结到这里,希望能够对你有所帮助~

    帖子永久地址: 

    黑帽联盟 - 论坛版权1、本主题所有言论和图片纯属会员个人意见,与本论坛立场无关
    2、本站所有主题由该帖子作者发表,该帖子作者与黑帽联盟享有帖子相关版权
    3、其他单位或个人使用、转载或引用本文时必须同时征得该帖子作者和黑帽联盟的同意
    4、帖子作者须承担一切因本文发表而直接或间接导致的民事或刑事法律责任
    5、本帖部分内容转载自其它媒体,但并不代表本站赞同其观点和对其真实性负责
    6、如本帖侵犯到任何版权问题,请立即告知本站,本站将及时予与删除并致以最深的歉意
    7、黑帽联盟管理员和版主有权不事先通知发贴者而删除本文

    您需要登录后才可以回帖 登录 | 会员注册

    发布主题 !fastreply! 收藏帖子 返回列表 搜索
    回顶部