triplepoint.mosquitto
Introducción
Instala y configura el broker MQTT Mosquitto.
Requisitos
Aunque no hay roles de dependencia explícitos, la máquina destino debe poder actuar como un host de Docker. El rol de Ansible geerlingguy.docker
es una solución adecuada.
Además, es posible que necesites alguna solución para implementar y mantener certificados SSL, lo cual estamos considerando fuera del alcance de este rol.
Finalmente, este rol creará un usuario y un grupo llamados mosquitto
en el host, con gid y uid 1883. Este usuario/grupo será el propietario de todos los directorios y archivos que se compartan en el contenedor del servicio. Esto está codificado en las imágenes de Docker de Eclipse, por lo que no hay mucha flexibilidad disponible.
Variables del Rol
Consulta el comentario en el archivo de variables predeterminado para información sobre la configuración.
Dependencias
Ninguna.
Ejemplo de Playbook
- hosts: whatever
roles:
- triplepoint.mosquitto
Pruebas del Rol
Este rol se prueba con molecule
, utilizando pipenv
para manejar las dependencias y el entorno de pruebas de Python.
Configurando tu Entorno de Ejecución
pip install pipenv
Una vez que tengas pipenv
instalado, puedes crear el entorno virtual de ejecución con:
pipenv install --dev
Ejecutando Pruebas
Una vez que tu entorno esté configurado, puedes ejecutar molecule
con:
pipenv run molecule test
Regenerando el Archivo de Bloqueo
No deberías tener que hacer esto muy a menudo, pero si cambias los requisitos de paquetes de Python usando comandos de pipenv install {some_package}
o editando directamente el Pipfile
, o si encuentras que las dependencias de construcción están desactualizadas, es posible que necesites regenerar el Pipfile.lock
.
pipenv update --dev
Asegúrate de guardar el Pipfile.lock
regenerado cuando este proceso esté completo.
Licencia
MIT
ansible-galaxy install triplepoint.mosquitto