Intro

This role sets up and configures a Dockerized ZWaveJS2MQTT application, which manages a Z-Wave radio network.

Requirements

There are no strict dependency roles, but the target machine needs to work as a Docker host. The geerlingguy.docker Ansible role is a good choice for this.

Role Variables

Check the comment in the default variables file for details on how to configure it.

Dependencies

None.

Example Playbook

- hosts: whatever
  roles:
    - triplepoint.zwavejs2mqtt

Role Testing

This role is tested using molecule, with pipenv handling dependencies and the Python testing setup.

Setting Up Your Execution Environment

pip install pipenv

After installing pipenv, you can create the execution virtual environment with:

pipenv install --dev

Running Tests

With your environment set up, run molecule by using:

pipenv run molecule test

Regenerating the Lock File

You shouldn't need to do this frequently, but if you change Python package requirements with pipenv install {some_package} or edit the Pipfile directly, or if your build dependencies are outdated, you may need to regenerate the Pipfile.lock.

pipenv update --dev

Make sure to check in the updated Pipfile.lock when done.

License

MIT