共计 1161 个字符,预计需要花费 3 分钟才能阅读完成。
介绍
为了使 Shifu 能够整合开发者的驱动,咱们编写了一个简略的 HTTP 到 SSH 的中间件来供开发者应用
设计
这个 HTTP 到 SSH 的中间件设计如下:
- 从中间件利用容器提供的公钥建设一个到容器的 SSH 连贯
- 这个 SSH 连贯会被用作反向 HTTP 代理,代理到 localhost 的制订 HTTP 端口
- 这个中间件会间接在 SSH 的会话中执行 HTTP 申请的 body 的内容
- 中间件会将执行内容的后果以及状态代理回复给请求者
性能
代理 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
(必填)- 用来建设 SSH 连贯到本身的 SSH 密钥门路
-
EDGEDEVICE_DRIVER_HTTP_PORT
(选填)- HTTP 服务的端口,默认为
11112
- HTTP 服务的端口,默认为
-
EDGEDEVICE_DRIVER_EXEC_TIMEOUT_SECOND
(选填)- 执行命令的超时,通过在命令后面加上
timeout <seconds>
来实现
- 执行命令的超时,通过在命令后面加上
-
EDGEDEVICE_DRIVER_SSH_USER
(选填)- 咱们 SSH 到本身容器的用户,默认为
root
- 咱们 SSH 到本身容器的用户,默认为