saltstack（七）modules(一)
模块是个啥呢？其实就是个文件。salt模块其实分为两类，一类模块，叫execution modules，这一类模块是在命令行上面执行的
来个内置执行模块的链接地址：
http://docs.saltstack.cn/ref/modules/all/index.html#all-salt-modules
还有一类模块，叫state modules，这一类模块是在state里面使用的
也来个内置state模块的链接：
http://docs.saltstack.cn/ref/states/all/index.html
先说执行模块是怎么写的吧。
执行模块，默认的路径在/srv/salt/_modules下
__salt__是个字典，是个啥字典呢，这个玩意，是属于salt全局的一个字典，只要我们定义的模块被minion加载后，就可以用__salt__了。
注意：这个__salt__字典，不是在我们模块里面自己定义的，而是salt全局的，我们写模块的时候直接拿来用就OK了
OK，知道__salt__是个啥之后，那个这东西里面都装了些什么玩意呢？
其实，__salt__这个字典里面装的minion上面所有的modules。__salt__的key是一个个的模块名称，value则是模块里面的一个个函数。
好，下面咱们看个例子，看看内建模块是怎么调用的。
这个foo.py是楼主自定义的一个模块，很简单，传一个参数进去，然后返回一段话
root@salt-master:~# cat /srv/salt/_modules/foo.py
def foo(name):
return"I am %s" % name
这个cheng.py也是楼主定义的一个模块，目的是通过__salt__调用我们上面定义的那个foo模块中的
foo函数
root@salt-master:~# cat /srv/salt/_modules/cheng.py
def cheng(name):
return __salt__['foo.foo'](name)
OK，咱们同步一下模块
root@salt-master:~# salt'*' saltutil.sync_modules
salt-minion:
- modules.cheng
- modules.foo
好，看一下结果！
root@salt-master:~# salt'*' cheng.cheng lisisi
salt-minion:
I am lisisi
root@salt-master:~#
通过这个例子，大家差不多该知道怎么调用__salt__里面的模块函数了吧。
好，咱们总结一下
使用格式：__salt__['模块.函数']('函数参数')
OK，下一个话题，来看看自定义的模块，怎样使用grains，pillar，以及编写文档，还有自定义输出格式。
看这个例子。
root@salt-master:~# cat -n /srv/salt/_modules/lisisi.py
1'''
2:maintainer: LiXiangcheng <626659817@qq.com>
3:maturity: new
4:depends:
5:platform: all
6'''
7__outputter__ = {
8 'lisisi': 'json'
9 }
10def lisisi(args):
11 '''
12 A function just one example
13 CLI Example:
14 salt '*' lisisi.lisisi args
15
16 '''
17 grain = __grains__['chengge']
18 pillar = __pillar__['group']
19 result = __salt__['cmd.run'](args)
20 result = "%s,%s,%s" % (grain,pillar,result)
21 returnresult
root@salt-master:~#
下面解释一下，1到6行都看得明白，是一些基本信息。
7到9行，是指定输出格式,__outputter__这个东西也是个字典，这个字典会绑定salt中的一个方法，当你以 函数名:输出格式 这种形式加入__outputter__这个字典后，salt就会帮你把你指定的函数，按照指定的格式打印返回值。
好了，那输出格式有哪些个呢？看下面
'grains','yaml','json','pprint','raw','highstate','quiet','key','txt','no_return','nested','virt_query'
看到了没，这么多。一般咱们用默认的就OK了，大多数的输出格式都不好看其实。楼主这里用json输出格式测试一下。
再看一下11～16行，这个东西是干啥的呢？这个东西，是把你这个函数的用法加到sys.doc里面的。
再看一下17行。这个用到grains，咋用的呢，也是通过salt默认的一个字典__grains__，你想去哪个grain的时候，这么用就ok了，__grains__['Id']
18行，这个用到了pillar，咋用的呢？和grains一个样，__pillar__['Id']
下面的几行就不说了。
OK，来看一下结果
好同步一下模块
root@salt-master:~# salt'*' saltutil.sync_modules
salt-minion:
- modules.lisisi
看一下doc，看看这个函数是咋用的？
root@salt-master:~# salt '*'-d lisisi.lisisi
lisisi.lisisi:
A function just one example
CLI Example:
salt '*' lisisi.lisisi args
OK，可以执行了，传个命令进行
root@salt-master:~# salt '*' lisisi.lisisi"ls /tmp"
{
"salt-minion": "1002,lixc,lixc1"
}
root@salt-master:~#
OK，关于执行模块，楼主看了官方文档，还有这么个功能，__virtual__， 这东西叫虚拟模块
这功能楼主一看，尼玛，这东西好像和C++里面的多态虚函数，差不多。
这东西咋用的呢？官网上的例子是pkg这个模块，安装软件，有很多平台啊，有debian用的apt-get，centos用的是yum，用这个函数就可以来自动的判断。。。
楼主举个小例子吧。
先看一下，楼主的这个模块是咋定义的？
root@salt-master:~# cat /srv/salt/_modules/foo.py
__virtualname__ = 'sisi'
def __virtual__():
if __grains__['chengge'] == 1002:
return True
return __virtualname__
def foo(name):
return"I am %s" % name
再看一下，chengge这个grains的value是啥，和楼主那个模块里都是1002，说明__virtual__这个函数会
返回True
root@salt-master:~# salt '*' grains.item chengge
salt-minion:
chengge: 1002
同步一下模块
root@salt-master:~# salt'*' saltutil.sync_modules
salt-minion:
- modules.foo
好，执行这个模块，正常打印了吧。
root@salt-master:~# salt'*' foo.foo lisisi
salt-minion:
I am lisisi
接着，咱们把1002随便改为1003吧，这时候1003这个值和chengge这个grain的value是不一致的，这时候
__virtual__这个函数返回__virtualname__,也就是'sisi'
root@salt-master:~# sed -i 's#1002#1003#g' /srv/salt/_modules/foo.py
查看一下，修改成功了没
root@salt-master:~# grep 1003 /srv/salt/_modules/foo.py
if __grains__['chengge'] == 1003:
OK，修改之后，再同步一下模块
root@salt-master:~# salt'*' saltutil.sync_modules
salt-minion:
- modules.foo
再执行一下模块，看到了没，模块不可用了。
root@salt-master:~# salt'*' foo.foo lisisi
salt-minion:
'foo.foo' is not available.
再这么访问一下，看到了神奇的地方了没
root@salt-master:/srv/salt/_modules# salt '*'sisi.foo lixc
salt-minion:
I am lixc
哈哈，大伙应该知道这东西大概怎么用了吧。其实__virtual__这东西，返回一个string的时候，模块就可用，当它返回False的时候。模块就不可用了。。。
如果__virtual__这个函数，返会__virtualname__，那么我们的模块的名字就会被改名，修改的名字就是__vitualname__对于的值。
我们可以根据__virtual__这个函数，来控制，自定义模块的使用场景。。。
哈哈，还有一个东西忘记提了，怎么同步模块呢，上面已经写了一种方法，楼主总结下吧。以下三种方法都可以同步模块
salt '*' state.highstate
salt '*' saltutil.sync_all
salt '*' saltutil.sync_modules
exection modules官方上还介绍了一个装饰器的功能。。楼主还没看懂。自定义state modules，楼主也没有看到呢，楼主先研究研究再写吧。
页:
[1]