ansible笔记（13）：变量（二）

一、setup模块

　　前一篇文章中已经初步的总结了变量的一些使用方法，这篇文章我们继续，只不过，这篇文章所涉及到的内容需要借助两个模块，所以在详细的总结变量的相关使用方法之前，会先描述一下这两个模块的用法。
当我们运行一个playbook时，默认都会运行一个名为“[Gathering Facts]”的任务，前文中已经大致的介绍过这个默认的任务，ansible通过“[Gathering Facts]”这个默认任务收集远程主机的相关信息（例如远程主机的IP地址，主机名，系统版本，硬件配置等信息），其实，这些被收集到的远程主机信息会保存在对应的变量中，当我们想要使用这些信息时，我们可以获取对应的变量，从而使用这些信息。
如果想要查看“[Gathering Facts]”任务收集的信息内容，我们可以借助一个模块：setup模块
当执行playbook时，playbook其实就是自动调用了setup模块从而执行了"[Gathering Facts]"任务，所以我们可以通过手动执行setup模块查看“[Gathering Facts]”任务收集到的信息，示例如下：

[root@ansible-control playbook]# ansible 192.168.10.3 -m setup

上述ad-hoc命令表示收集192.168.10.3主机的相关信息，执行上述命令后，远程主机192.168.10.3的相关信息将会输出到ansible主机的控制台上，返回的信息的格式是json格式，我的返回信息如下：
注：由于返回的信息比较多，此处为了方便示例，我将部分内容删除（或折叠省略）了，所以如下返回信息并不完全，只用于示意。

[root@ansible-control playbook]# ansible 192.168.10.3 -m setup
192.168.10.3 | SUCCESS => {
"ansible_facts": {
"ansible_all_ipv4_addresses": [
"192.168.10.3",
"192.168.122.1"
],
"ansible_all_ipv6_addresses": [
"fe80::1f2f:cc8b:e62b:863b",
"fe80::199a:2158:dfe7:4fe5",
"fe80::8c0d:6c18:2f44:573a"
],
"ansible_apparmor": {
"status": "disabled"
},
"ansible_architecture": "x86_64",
"ansible_bios_date": "05/19/2017",
"ansible_bios_version": "6.00",
"ansible_cmdline": {
"BOOT_IMAGE": "/vmlinuz-3.10.0-957.el7.x86_64",
"LANG": "zh_CN.UTF-8",
"crashkernel": "auto",
"quiet": true,
"rd.lvm.lv": "centos/swap",
"rhgb": true,
"ro": true,
"root": "/dev/mapper/centos-root"
},
"ansible_date_time": {
"date": "2019-08-25",
"day": "25",
"epoch": "1566700526",
"hour": "10",
"iso8601": "2019-08-25T02:35:26Z",
"iso8601_basic": "20190825T103526546802",
"iso8601_basic_short": "20190825T103526",
"iso8601_micro": "2019-08-25T02:35:26.546939Z",
"minute": "35",
"month": "08",
"second": "26",
"time": "10:35:26",
"tz": "CST",
"tz_offset": "+0800",
"weekday": "星期日",
"weekday_number": "0",
"weeknumber": "33",
"year": "2019"
},
"ansible_default_ipv4": {
"address": "192.168.10.3",
"alias": "ens33",
"broadcast": "192.168.10.255",
"gateway": "192.168.10.254",
"interface": "ens33",
"macaddress": "00:0c:29:10:45:2d",
"mtu": 1500,
"netmask": "255.255.255.0",
"network": "192.168.10.0",
"type": "ether"
},
"ansible_default_ipv6": {},
"ansible_device_links": {
"ids": {
"dm-0": [
"dm-name-centos-root",
"dm-uuid-LVM-ZZUQOeHWfHVeQ2mGcQ3nlWQW0bSGeph90XISTL67goS7QJc7HNMRWJSiyZ1eStbc"
],
"dm-1": [
..............................................................................................

相关参数举例：

“ansible_all_ipv4_addresses”表示远程主机中的所有ipv4地址，从其对应的值可以看出，test70主机上一共有4个ipv4地址。
“ansible_distribution”表示远程主机的系统发行版，从其对应的值可以看出test70主机的系统发行版为centos。
“ansible_distribution_version”表示远程主机的系统版本号，从其对应的值与“ansible_distribution” 的值可以看出192.168.10.3主机的系统版本为centos7.6。
“ansible_ens35”表示远程主机ens35网卡的相关信息。
“ansible_memory_mb”表示远程主机的内存配置信息。

返回的信息的确很多，很全面，但是，并不是每一次我们都需要看这么多信息，如果你只是想查看某一类信息，你可以通过关键字对信息进行过滤，比如，我只是想要查看远程主机的内存配置信息，那么我可以使用如下命令：

[root@ansible-control playbook]# ansible 192.168.10.3 -m setup -a 'filter=ansible_memory_mb'
192.168.10.3 | SUCCESS => {
"ansible_facts": {
"ansible_memory_mb": {
"nocache": {
"free": 456,
"used": 516
},
"real": {
"free": 66,
"total": 972,
"used": 906
},
"swap": {
"cached": 0,
"free": 2045,
"total": 2047,
"used": 2
}
},
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false
}

这样就精简很多了，因为精准的返回了你需要的信息，我知道，有的朋友可能跟我一样，记性不好，所以通常记不住准确的关键字，所以我们可以使用通配符，进行相对模糊的过滤，示例如下：

[root@ansible-control playbook]# ansible 192.168.10.3 -m setup -a "filter=*mb*"

其实，除了这些信息以外，我们还能够在远程主机中写入一些自定义的信息，这些自定义信息也可以被setup模块收集到。

那么，我们应该在哪里定义这些信息呢？该怎样定义这些信息呢？

ansible默认会去目标主机的/etc/ansible/facts.d目录下查找主机中的自定义信息，并且规定，自定义信息需要写在以“.fact”为后缀的文件中，同时，这些以“.fact”为后缀的文件中的内容需要是INI格式或者是json格式的。

那么，我们来创建一个测试文件，测试文件路径为192.168.10.3主机的/etc/ansible/facts.d/testinfo.fact，在文件中写入如下INI格式的信息。

[root@ansible-control facts.d]# cat testinfo.fact
[testmsg]
msg1=This is the first custom test message
msg2=This is the second custom test message

如上所示，上述内容是一段INI风格的内容，我在“[testmsg]”配置段中配置了两条自定义信息，msg1与msg2。
当然，我们也可以使用json格式进行配置，比如在/etc/ansible/facts.d/testinfo.fact文件中写入如下配置，如下配置与上述配置的效果是相同的，只是书写格式不同。

{
   "testmsg":{
       "msg1":"This is the first custom test message",
       "msg2":"This is the second custom test message"
   }
}

通过上述方式，我们可以在目标主机的本地自定义信息，这些在远程主机本地自定义的信息被称为“local facts”，当我们运行setup模块时，远程主机的“local facts”信息也会被收集，我们可以通过“ansible_local”关键字过滤远程主机的“local facts”信息，示例命令如下：

[root@ansible-control /]# ansible 192.168.10.3 -m setup -a "filter=ansible_local"
192.168.10.3 | SUCCESS => {
"ansible_facts": {
"ansible_local": {
"testinfo": {
"testmsg": {
"msg1": "This is the first custom test message",
"msg2": "This is the second custom test message"
}
}
},
"discovered_interpreter_python": "/usr/bin/python"
},
"changed": false
}

之前说过，当setup收集远程主机的“local facts”时，默认会查找远程主机的/etc/ansible/facts.d目录，如果你把“local facts”信息文件放在了其他自定义路径，在使用setup模块时，需要使用“fact_path”参数指定对应的路径，假设，我把“.fact”文件放在了目标主机的“/testdir”目录下，示例命令如下：

[root@ansible-control /]# ansible 192.168.10.3 -m setup -a "fact_path=/test"

二、debug模块

　　debug模块的作用就是帮助我们进行调试的，debug模块可以帮助我们把信息输出到ansible控制台上，以便我们能够定位问题。那么我们先来看一个debug模块的playbook小示例，如下：

---
- hosts: 192.168.10.3
remote_user: root
tasks:
- name: touch file
file:
path: /test/testfile
state: touch
- name: debug demo
debug:
msg: this is debug info,The test file has been touched

上例中，我们先在192.168.10.3主机上touch了对应的文件，然后，利用debug模块在控制台中输出了我们想要显示的信息，如你所见，debug模块的msg参数可以指定我们想要输出的信息，上述playbook表示touch完对应的文件以后，在ansible控制台中输出我们指定的信息，那么我们运行一下这个测试剧本，看一下效果，如下：

debug模块除了能够使用msg参数输出自定义的信息，还能够直接输出变量中的信息，通过debug模块直接输出变量信息需要使用var参数，示例如下：

---
- hosts: 192.168.10.3
remote_user: root
vars:
testvar: value of test variable
tasks:
- name: debug demo
debug:
var: testvar

上例虽然连接到了test70远程主机，但是并没有对192.168.10.3主机做任何操作，只是在playbook中定义了一个变量，并且通过debug的var参数输出了这个变量的内容，只是为了单纯的演示debug模块的var参数的使用方法，上述playbook的执行效果如下：

变量的名称以及变量的值都输出到了屏幕上，这个功能可以帮助我们调试playbook中变量，让我们了解变量的值是否符合我们的要求。

当然，使用debug的msg参数时也可以引用变量的值，这样我们自定义的信息就更加灵活了，示例如下：

---
- hosts: 192.168.10.3
remote_user: root
vars:
testvar: testv
tasks:
- name: debug demo
debug:
msg: "value of testvar is :{{testvar}}"

上例中的msg自定义信息中引用了testvar变量的值
注：上例中msg的值需要使用引号引起，因为{{testvar}}变量前包含“冒号”，如果不使用引号会报语法错误。
上例输出效果如下：

回归正题：

　　setup模块与debug模块了解完了，现在绕回一开始的话题，playbook在运行时默认都会运行“[Gathering Facts]”任务，“[Gathering Facts]”任务会收集远程主机的相关信息，这些信息会保存在对应的变量中，我们在playbook中可以使用这些变量，从而利用这些信息，那么我们怎样在playbook获取到这些变量的值呢？在setup模块的示例中，我们可以通过“ansible_memory_mb”关键字获取远程主机的内存信息，其实，“ansible_memory_mb”就是一个变量名，换句话说就是，我们可以在playbook中直接引用名为“ansible_memory_mb”的变量，从而获取到远程主机的内存信息，示例如下：

---
- hosts: 192.168.10.3
remote_user: root
tasks:
- name: debug demo
debug:
msg: "Rometo host memory information :{{ansible_memory_mb}}"