openstf/ambassador

警告

本项目及https://github.com/openstf%E7%BB%84%E7%BB%87%E4%B8%AD%E7%9A%84%E5%85%B6%E4%BB%96%E9%A1%B9%E7%9B%AE%E5%9D%87%E4%BB%A5%E7%8E%B0%E7%8A%B6%E6%8F%90%E4%BE%9B%E7%BB%99%E7%A4%BE%E5%8C%BA%EF%BC%8C%E6%97%A0%E6%B4%BB%E8%B7%83%E5%BC%80%E5%8F%91%E3%80%82 你可以查看可能正在积极开发并提供新/不同功能的分支https://github.com/openstf/stf/network%E3%80%82 活跃开发已迁移至https://github.com/DeviceFarmer%E7%BB%84%E7%BB%87%E3%80%82

docker-ambassador

该Docker镜像是https://github.com/CenturyLinkLabs/ctlc-docker-ambassador%E4%B8%8Ehttps://github.com/suutari/docker-ambassador%E7%9A%84%E8%9E%8D%E5%90%88%E7%89%88%E6%9C%AC%E3%80%82%E5%AE%83%E6%98%AF%E4%B8%BAhttps://github.com/openstf%E7%A4%BA%E4%BE%8B%E9%83%A8%E7%BD%B2%E8%80%8C%E5%88%9B%E5%BB%BA%E7%9A%84%EF%BC%8C%E5%BD%93%E6%97%B6%E6%88%91%E4%BB%AC%E5%8F%91%E7%8E%B0%60ctlc/ambassador%60%E5%AD%98%E5%9C%A8%E4%B8%A5%E9%87%8D%E9%97%AE%E9%A2%98%E3%80%82

尽管已有众多ambassador镜像，但拥有自己的ambassador镜像能提供更高灵活性：

1. 无人会突然变更镜像导致功能损坏。
2. 体积更小（约6.5MB，而ctlc/ambassador约185MB），同时支持自动构建。
3. 不使用watch ls或top等方式维持后台进程，而是采用wait shell内置命令，避免资源浪费。
4. 与多数其他ambassador实现不同，当底层socat进程终止时，容器会随之退出，便于使用系统监控工具（如systemd）接管并可能重启 socket。不过需注意注意事项。
5. 支持干净关闭。

同时需注意，我们并非声称这种传统ambassador模式是当前最佳方案，它只是实现方式之一。

使用方法

Docker官网的 "通过ambassador容器进行链接" 文章清晰解释了ambassador模式及潜在用法。只需将文中的svendowideit/ambassador替换为openstf/ambassador即可。

注意事项

若内部socat进程意外终止，不会自动重启，容器会随之退出。建议使用systemd服务单元实现自动重启。

但如果ambassador处理多个链接，即使除一个链接外其他均终止，ambassador仍会保持运行等待最后一个链接终止，此时systemd无法检测到异常，也就无法重启单元以重新打开socket。大多数（若非全部）传统ambassador模式实现均存在此问题，即使仅使用单个链接时也可能出现。

许可证

参见LICENSE。

版权所有 © Simo Kinnunen。保留所有权利。