zsk008/liveshell

使用野狗开发一个远程调用shell脚本的工具。运维工程师的利器。

####工具说明：

liveshell 工具是采用 WildDog 云以及WildDog C/嵌入式 SDK 制作的，远程调用 shell 脚本的工具。它监听某个 url 下数据的变化，当数据发生变化后，触发预先安排好的可执行程序或者 shell 脚本，同时将变化后的数据作为参数传入。

WildDog C/嵌入式 SDK 使用的是CoAP UDP + DTLS + CBOR技术。

Linux发行版均可使用该工具，已在以下发行版中测试通过：

Linux版本                                                       内核版本
centos-release-7-1.1503.el7.centos.2.8.x86_64                   3.10.0-229.el7.x86_64
centos-release-6-5.el6.centos.11.1.x86_64                       2.6.32-431.el6.x86_64
centos-release-5.5.el5.centos                                   2.6.18-194.el5
Red Hat Enterprise Linux Server release 7.1  (Maipo)            3.10.0-229.el7.x86_64
Red Hat Enterprise Linux Server release 6.6 (Santiago)          2.6.32-504.el6.x86_64
Red Hat Enterprise Linux Server release 5.11 (Tikanga)          2.6.18-398.el5
Ubuntu14.04.01                                                  3.16.0-30-generic
Ubuntu12.04                                                     3.13.0-32-generic

除了上述各大主流的 Linux 发行版可以使用，在openwrt系统中同样可以使用 liveshell 工具，具体的安装步骤请参见openwrt-liveshell目录下的liveshell_used_in_Openwrt.md文档。

####linux环境下安装说明： #####1. 下载

从git下载到文件夹

git clone https://github.com/WildDogTeam/liveshell.git

更新C/嵌入式SDK

cd liveshell	
git submodule update --init --recursive

#####2. 安装 注意权限，install 需要 root 权限

./configure
make
make install

######configure 配置参数说明

--with-endian=ARG       大小端, ARG可设为big|little,  默认little
--with-bits=ARG         机器位数, ARG可设为8|16|32|64, 默认32
--with-maxsize=ARG      应用层协议长度, ARG可设为0~1300, 默认1280
--with-queuenum=ARG     消息队列个数, 默认32
--with-retranstime=ARG  重传超时时间（ms）, 默认10000ms
--with-recvtimeout=ARG  单次最大接收时间（ms）, 默认100ms
--with-sectype=ARG      加密方式, ARG可设为nosec|mbedtls|tinydtls, 默认tinydtls

#####3.使用

liveshell  [option] <your wilddog url> <your callback command>

liveshell 命令监听your wilddog url下数据的变化，当数据发生变化时，调用your callback command，并且将最新的数据（json字符串）作为第一个参数传递给your callback command，注意，your callback command需要本身能够在 console 中执行，如果your callback command还需要 root 权限，请用 root 权限调用liveshell。

######liveshell 命令参数说明

-o 获取到原始数据也会触发一次 command 回调

-s 当数据为字符串时，不解析该字符串，完整的将该字符串（以双引号包裹）传递给 command 回调

-v 触发回调时将命令完整打出

-h 打印帮助信息

--version 打印版本号

--authvalue=<your auth data> 传入auth数据（如超级密钥、token等）

#####4. 例子

######显示根目录的文件

1. 在 WildDog 云端建立一颗数据树，结构为

    {
      "path": "/"
    }	
   

2. 终端运行 liveshell，将<your Appid>替换成你自己的appid

    liveshell coaps://<your Appid>.wilddogio.com/path ls
   

3. 终端的显示结果等同于在终端运行"ls /"，修改云端数据，把"/"改为"-l /"，在终端立刻显示"ls -l /"的结果；类似的，你也可以将改为 shell 脚本，执行更加复杂的操作。

4. 在传入 auth 数据的情况下，我们可以将云端安全规则中的读写权限配置为 false，这样只有在 auth 正确的条件下，才可以读写。

    liveshell --authvalue=XXXXXXXEFAHYAUDAF1SACfEXXXXXXX coaps://<your Appid>.wilddogio.com/path ls