Saltstack 新特性测试之proxy minion

salt 目前主要的应用场景是Linux OS下，另外还有Windows Client（Win下没用过，但是看官方issue，应该……），最近关注到官方的一个小模块提到了Proxy minion，群里也多有提及，便想着看看到底是啥存在。 任何设备均可被salt托管 salt proxy minion的出现，

salt 目前主要的应用场景是Linux OS下，另外还有Windows Client（Win下没用过，但是看官方issue，应该……），最近关注到官方的一个小模块提到了Proxy minion，群里也多有提及，便想着看看到底是啥存在。

任何设备均可被salt托管

salt proxy minion的出现，使得网管设备或者哑设备（比如sms gateway）均可被salt统一管理，而实际的管理模块或通讯接口均由用户自行编写好，具体操作内容请参见salt 官网对应的 Proxy Minion 介绍

开发中的新特性

首先需要注意一点，Proxy minion是2014.1.x版本引进的新特性，并且到目前为止仍处于开发阶段，仅可用作测试用途。

测试环境的准备

本人的PC环境：

• vbox下ubuntu 14.04 LTS Server
• Salt master & minion 2014.1.7（配置test.ping通，不多说了）

准备好基础环境之后，需要从github下载salt官方开发人员用于测试Proxy Minion的一个小程序（Rest Server，模拟网管设备的管理接口），名字是 salt-proxy-rest。

这个程序可能依赖两个python库，bottle和requests（其实就是web server需要的组件……），安装一下即可。

使用 python rest.py 运行该程序，可以将此作为一个网管设备的Web管理接口：

尝试运行!

至此，准备工作算是完成。在当前环境下，salt-master和salt-minion稳定运行，并且有一个提供REST接口的网管设备在独立工作，我们需要做的便是将其拉进Salt的阵营。

配置pillar

鄙人的minion id是docker，对应的pillar的top.sls内容配置为：

root@docker:/srv/pillar# cat top.sls
base:
  docker:
    - proxyminion

而proxyminion.sls内容则是对应网管设备的描述：

root@docker:/srv/pillar# cat proxyminion.sls 
proxy:
  rest_sample:
    proxytype: rest_sample
    url: http://127.0.0.1:8080/
    id: proxy_docker

这里需要注意的是，proxytype必须是在salt/proxy下已经预先定义好的，而其他的一些参数则是自己网管设备通信需要的一些数据，不一定相同。

定义好pillar数据之后，需要为之添加对应的proxy conn class和grains数据，这里鄙人使用官方sample，就偷个懒：

root@docker:/srv/pillar# cat /usr/lib/python2.7/dist-packages/salt/proxy/rest_sample.py
# -*- coding: utf-8 -*-
'''
This is a simple proxy-minion designed to connect to and communicate with
the bottle-based web service contained in salt/tests/rest.py.
Note this example needs the 'requests' library.
Requests is not a hard dependency for Salt
'''
……

放心，2014.1.7版本已经默认有这个sample代码。 接下来，直接test.ping试试吧！

root@docker:/srv/pillar# salt '*' test.ping -v
Executing job with jid 20140720110315049478
-------------------------------------------
docker:
    True
rest_sample-localhost:
    True

诶，等一下，为什么多出来个key？为什么还能test.ping通？没错！这个就是ProxyMinion，而salt默认已经配置了test.ping方法兼容proxy minion了，只要写好对应的ping模块，就可以使用常规的test.ping来探测！（本例的ping代码如下）

def ping(self):
    '''
    Is the REST server up?
    '''
    r = requests.get(self.url+'ping')
    try:
        if r.status_code == 200:
            return True
        else:
            return False
    except Exception:
        return False

rest_sample还提供很多function，比如鄙人测试的一个service_status，修改对应的模块代码即可使之兼容proxy minion（代码路径为/usr/lib/python2.7/dist-packages/salt/modules/service.py）：

def status(name, sig=None):
    '''
    Return the status for a service, 
    returns the PID or an empty string if the
    service is running or not, pass a signature
    to use to find the service via ps
    CLI Example:
    .. code-block:: bash
    salt '*' service.status  [service signature]
    '''
    #wjx add, denote it to work!!
    #if 'proxyobject' in __opts__:
    #    return __opts['proxyobject'].service_status(sig if sig else name)
    return __salt__['status.pid'](sig if sig else name)

那么这时候再看看当前proxy minion管理的服务状态咋样了：

root@docker:/srv/pillar# salt '*' service.status apache
rest_sample-localhost:
    ----------
    comment:
        stopped
    ret:
        True
docker:
    False

完全和普通minion兼容！！rest_sample本身还配置了grain数据，代码位于/usr/lib/python2.7/dist-packages/salt/grains/rest_sample.py，直接敲命令看看：

root@docker:/srv/pillar# salt 'rest_sample-localhost' grains.items
rest_sample-localhost:
    housecat: Are you kidding?
    kernel: 0.0000001
    location: In this darn virtual machine.  Let me out!
    os: RestExampleOS
    os_family: proxy

Awesome！！这样一来，一个基本的salt proxy minion就算是配置完成，Proxy Minion 的类定义代码位于/usr/lib/python2.7/dist-packages/salt/minion.py，有兴趣可以看看。

可能的bug

鄙人在本机测试时，Minion Docker在尝试fork出一个ProxyMinion过程中间报错，说_running参数没有配置，在添加代码后通过（即位于minion.py代码里）

class ProxyMinion(Minion):
'''
This class instantiates a 'proxy' minion--a minion that does not manipulate
the host it runs on, but instead manipulates a device that cannot run a minion.
'''
def __init__(self, opts, timeout=60, safe=True):  # pylint: disable=W0231
    '''
    Pass in the options dict
    '''
    #wjx add, maybe a bug
    self._running = None
    # Warn if ZMQ 
聊聊Proxy Minion
Proxy minion使得salt针对网管设备的配置管理成为可能，不过想要实现一个ProxyType的ProxyMinion的完全管理，可能需要编写很多额外的module去支持它的运行。
在大公司复杂的网络环境下，完全可以针对此编写对应SNMP管理模块或者针对OVS编写对应的管理模块，尔后通过salt统一托管，毕竟Salt有一套完善的配置管理体系啊！
    

        原文地址：Saltstack 新特性测试之proxy minion, 感谢原作者分享。