triplepoint.mosquitto
介绍
安装和配置 Mosquitto MQTT 代理。
需求
虽然没有明确的依赖角色,但目标机器应该能够作为 Docker 主机。使用 geerlingguy.docker
Ansible 角色是一个合适的解决方案。
此外,您可能需要一些解决方案来部署和维护 SSL 证书,这不在此角色的范围内。
最后,此角色将在主机上创建名为 mosquitto
的用户和组,gid 和 uid 为 1883。该用户/组将拥有所有共享到服务容器中的目录和文件。这在 Eclipse Docker 镜像中是硬编码的,因此没有太多灵活性。
角色变量
有关配置的信息,请查看 默认变量文件中的注释。
依赖项
无。
示例剧本
- hosts: whatever
roles:
- triplepoint.mosquitto
角色测试
此角色使用 molecule
进行了测试,使用 pipenv
来处理依赖项和 Python 测试环境。
设置执行环境
pip install pipenv
安装 pipenv
后,您可以使用以下命令构建执行虚拟环境:
pipenv install --dev
运行测试
配置好环境后,您可以执行 molecule
:
pipenv run molecule test
重新生成锁定文件
您不需要经常这样做,但如果您使用 pipenv install {some_package}
命令更改 Python 包需求,或直接编辑 Pipfile
,或者如果您发现构建依赖项过时,您可能需要重新生成 Pipfile.lock
:
pipenv update --dev
完成此过程后,请确保检查重新生成的 Pipfile.lock
。
许可证
MIT