关于物联网:Shifu高级功能命令行中间件之HTTP-到-PowerShell-的中间件

简介

为了让你的设施接入Shifu。咱们用 Go 编写了一个简略的 HTTP 到 PowerShell 的中间件，供开发者应用。

设计

这个 HTTP 到 PowerShell 的中间件是这样设计的：

• 中间件在主机上裸露了一个 HTTP 接口
• 该 HTTP 接口用于转发来自内部的申请到 Windows 主机
• 中间件将代理后果和执行状态返回给请求者

性能

将 HTTP 申请体代理到 PowerShell shell 并执行

承受 HTTP 申请体中的所有内容，并在规定超时工夫内执行。

构建中间件

操作

386

GOOS=windows GOARCH=386 go build -a -o http2powershell.exe cmd/httpstub/powershellstub/powershellstub.go

amd64

GOOS=windows GOARCH=amd64 go build -a -o http2powershell.exe cmd/httpstub/powershellstub/powershellstub.go

应用办法

该可执行文件须要配置以下环境变量：

• EDGEDEVICE_DRIVER_HTTP_PORT (可选)

  • 驱动程序容器的 HTTP 服务器端口，默认为11112。

• EDGEDEVICE_DRIVER_EXEC_TIMEOUT_SECOND (可选)

  • 执行指令的超时工夫，能够通过在命令后面加上 timeout <seconds> 来实现。

对于 Windows 主机的操作：

如果要运行中间件，请双击 http2powershell.exe，默认状况下，中间件会在0.0.0.0 上监听 11112 端口。

对于 Shifu 的操作：

应用 /examples/simple-powershell-stub 中提供的样本部署文件。

在 shifu 的根目录下公布：

kubectl apply -f driver_util/http-to-powershell-stub/examples/Simple-powershell-stub

代理命令

应用 curl 向Windows主机公布申请：

root@nginx:/# curl "edgedevice-powershell/issue_cmd?flags_no_parameter=ls,C:"
    Directory: C:\
Mode                 LastWriteTime         Length Name                                                   
----                 -------------         ------ ----                                                   
d-----          6/5/2021   8:10 PM                PerfLogs                                               
d-r---          6/9/2022   2:48 PM                Program Files                                          
d-r---         4/29/2022   8:02 PM                Program Files (x86)                                    
d-r---         4/16/2022   1:46 AM                Users                                                  
d-----          6/9/2022   2:48 PM                Windows                                                
d-----         4/17/2022   5:23 PM                xampp                                                     

root@nginx:/# curl "edgedevice-powershell/issue_cmd?flags_no_parameter=ping,8.8.8.8"

Pinging 8.8.8.8 with 32 bytes of data:
Reply from 8.8.8.8: bytes=32 time=64ms TTL=114
Reply from 8.8.8.8: bytes=32 time=56ms TTL=114
Reply from 8.8.8.8: bytes=32 time=57ms TTL=114
Reply from 8.8.8.8: bytes=32 time=59ms TTL=114

Ping statistics for 8.8.8.8:
    Packets: Sent = 4, Received = 4, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 56ms, Maximum = 64ms, Average = 59ms

示例

当应用 curl 向一个给定的 URL 公布申请时，命令如下：

curl "example.com/issue_cmd?flags_no_parameter=ping,8.8.8.8。

而后申请将从 HTTP 的中间件传到 Windows 主机的PowerShell。

> powershell.exe ping 8.8.8.8。

请留神，默认的定时 EDGEDEVICE_DRIVER_EXEC_TIMEOUT_SECOND 能够被 URL 中的 timeout 标记所笼罩，例如：

• 如果没有 timeout 标记（命令超时，输入不残缺）：

root@nginx:/# curl "example.com/issue_cmd?flags_no_parameter=ping,-n,6,8.8.8.8"   

Pinging 8.8.8.8 with 32 bytes of data:
Reply from 8.8.8.8: bytes=32 time=58ms TTL=114
Reply from 8.8.8.8: bytes=32 time=51ms TTL=114
Reply from 8.8.8.8: bytes=32 time=59ms TTL=114
Reply from 8.8.8.8: bytes=32 time=45ms TTL=114
Reply from 8.8.8.8: bytes=32 time=59ms TTL=114

• 应用 timeout 标记（输入残缺）：

root@nginx:/# curl "example.com/issue_cmd?timeout=10&flags_no_parameter=ping,-n,6,8.8.8.8" 

Pinging 8.8.8.8 with 32 bytes of data:
Reply from 8.8.8.8: bytes=32 time=60ms TTL=114
Reply from 8.8.8.8: bytes=32 time=60ms TTL=114
Reply from 8.8.8.8: bytes=32 time=59ms TTL=114
Reply from 8.8.8.8: bytes=32 time=59ms TTL=114
Reply from 8.8.8.8: bytes=32 time=59ms TTL=114
Reply from 8.8.8.8: bytes=32 time=60ms TTL=114

Ping statistics for 8.8.8.8:
    Packets: Sent = 6, Received = 6, Lost = 0 (0% loss),
Approximate round trip times in milli-seconds:
    Minimum = 59ms, Maximum = 60ms, Average = 59ms

咱们还增加了一个参数 stub_toleration 来解决 deviceShifu 和中间件之间的提早问题。默认状况下，它被设置为 1 秒, 你能够用以下办法笼罩这个工夫:

root@nginx:/# curl "example.com/issue_cmd?timeout=10&flags_no_parameter=ping,-n,6,8.8.8.8&stub_toleration=0"