Introduction

Installez et configurez le broker MQTT Mosquitto.

Exigences

Bien qu'il n'y ait pas de dépendances explicites, la machine cible doit pouvoir agir en tant qu'hôte Docker. Le rôle Ansible geerlingguy.docker est une solution appropriée.

De plus, vous aurez peut-être besoin d'une solution pour déployer et gérer des certificats SSL, qui est considérée comme hors du périmètre de ce rôle.

Enfin, ce rôle créera un utilisateur et un groupe nommés mosquitto sur l'hôte, avec un gid et un uid de 1883. Cet utilisateur/groupe possédera tous les répertoires et fichiers partagés dans le conteneur de service. Cela est codé en dur dans les images Docker Eclipse, donc il n'y a pas beaucoup de flexibilité.

Variables de rôle

voir le commentaire dans le fichier de variables par défaut pour plus d'informations sur la configuration.

Dépendances

Aucune.

Exemple de Playbook

- hosts: n'importe quel hôte
  roles:
    - triplepoint.mosquitto

Tests du rôle

Ce rôle est testé avec molecule, en utilisant pipenv pour gérer les dépendances et l'environnement de test Python.

Configurer votre environnement d'exécution

pip install pipenv

Une fois que vous avez installé pipenv, vous pouvez construire l'environnement virtuel d'exécution avec :

pipenv install --dev

Exécuter les tests

Une fois que votre environnement est configuré, vous pouvez exécuter molecule avec :

pipenv run molecule test

Régénération du fichier de verrouillage

Vous ne devriez pas avoir à faire cela très souvent, mais si vous modifiez les exigences des packages Python avec les commandes pipenv install {some_package} ou en éditant directement le Pipfile, ou si vous constatez que les dépendances de construction ne sont plus à jour, vous devrez peut-être régénérer le Pipfile.lock.

pipenv update --dev

Assurez-vous de bien vérifier le Pipfile.lock régénéré une fois ce processus terminé.

Licence

MIT