为了使Shifu可以整合开发者的驱动,我们编写了一个简单的 HTTP 到 SSH 的中间件来供开发者使用
这个 HTTP 到 SSH 的中间件设计如下:
代理 HTTP body 的内容到 SSH shell 并执行
中间件的主要功能就是将任意HTTP 请求中 body 的内容附加一个超时并执行
举例:
当使用curl
去 Post 一个请求到制定 URL, 会是如下命令:
curl -X POST -d "ping 8.8.8.8" http://example.com
这个请求会被中间件传递到驱动容器中的shell
中执行:
~ # ping 8.8.8.8
HTTP 的返回结果如下 (注意这个输出不全,是因为我们设定了一个命令超时的环境变量):
PING 8.8.8.8 (8.8.8.8): 56 data bytes 64 bytes from 8.8.8.8: seq=0 ttl=36 time=47.227 ms 64 bytes from 8.8.8.8: seq=1 ttl=36 time=50.137 ms 64 bytes from 8.8.8.8: seq=3 ttl=36 time=47.619 ms
检查session.Run(cmd)
错误并设定 HTTP 的返回状态码
当前中间件会在成功时返回200
, 错误或超时时返回400
对于出错的命令,中间件会将stdout
和stderr
合并到一起通过 HTTP 的 body 返回
我们写了一个 Dockerfile 的示例在[examples/driver_utils/simple-alpine/Dockerfile.sample](https://github.com/Edgenesis/shifu/blob/main/examples/driver_utils/simple-alpine/Dockerfile.sample)
,其中演示了如何将这个中间件加入到一个 alpine 的 Docker 镜像中
打包的 Docker 镜像会使用以下变量,因此我们需要在yaml文件中进行配置:
EDGEDEVICE_DRIVER_SSH_KEY_PATH
(必填)
EDGEDEVICE_DRIVER_HTTP_PORT
(选填)
11112
EDGEDEVICE_DRIVER_EXEC_TIMEOUT_SECOND
(选填)
timeout <seconds>
来实现EDGEDEVICE_DRIVER_SSH_USER
(选填)
root