Return组件可以理解为saltstack系统对执行minion返回后的数据进行存储或者返回给其他程序
它支持多种存储方式,比如mysql、mongoDB、redis、memcached等,通过return我们可以对saltstack的每次操作进行记录,对以后日志审计提供了数据来源。
官方有30种return数据存储与接口,我们可以很方便的配置与使用它。当然也支持自己定义的return。
查看所有return列表
salt ‘minion1‘ sys.list_returners
minion1:
- carbon
- couchdb
- etcd
- hipchat
- local
- local_cache
- multi_returner
- redis
- slack
- smtp
- sqlite3
- syslog
return流程
return是在master端触发任务,然后minion接受处理任务后直接与return存储服务器建立连接,然后把数据return存到存储服务器。这个过程都是minion端操作存储服务器,所以要确保minion端的配置跟依赖包是正确的
使用redis作为return存储方式
这里我们就借用官网的例子来熟悉下怎么使用return,我们使用redis作为return的存储方式
minion配置文件
在minion上安装redis Python client
首先需要在minion配置文件里面定义return存储服务器信息,添加redis服务器信息即可
redis.db: ‘0‘
redis.host: ‘127.0.0.1‘
redis.port: ‘6379‘
minion配置文件添加好后,安装依赖,使minion能操作redis服务器
重启minion端,/etc/init.d/salt-minion restart
在执行return之前,可以先登录到redis服务器上查看redis monitor信息。这样我们可以实时查看redis相关操作,现在我们在master上执行一个module,然后return到redis
master端:
salt ‘minion1‘ cmd.run ‘hostname‘ --return redis
minion1:
minion1
redis端:
./redis-cli monitor
OK
1461054358.412376 [0 127.0.0.1:58564] "SELECT" "0"
1461054358.412717 [0 127.0.0.1:58564] "SET" "minion1:20160419162558137768" "{\"fun_args\": [\"hostname\"], \"jid\": \"20160419162558137768\", \"return\": \"minion1\", \"retcode\": 0, \"success\": true, \"fun\": \"cmd.run\", \"id\": \"minion1\"}"
1461054358.413143 [0 127.0.0.1:58564] "LPUSH" "minion1:cmd.run" "20160419162558137768"
1461054358.413482 [0 127.0.0.1:58564] "SADD" "minions" "minion1"
1461054358.413791 [0 127.0.0.1:58564] "SADD" "jids" "20160419162558137768"
格式是JSON