Intro

This role sets up and configures a Dockerized Home-Assistant application.

Requirements

There are no specific dependency roles needed, but the target machine must function as a Docker host. You can use the geerlingguy.docker Ansible role for this.

Role Variables

Check the comment in the default variables file for configuration details.

Dependencies

None.

Example Playbook

- hosts: whatever
  roles:
    - triplepoint.home_assistant

Role Testing

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

Setting Up Your Execution Environment

pip install pipenv

After installing pipenv, create the execution virtual environment by running:

pipenv install --dev

Running Tests

Once your environment is ready, you can run molecule tests with:

pipenv run molecule test

Regenerating the Lock File

You shouldn't need to do this often, but if you modify the Python package requirements with commands like pipenv install {some_package} or by editing the Pipfile directly, or if your build dependencies are outdated, you may need to regenerate the Pipfile.lock.

pipenv update --dev

Remember to check in the updated Pipfile.lock after finishing this process.

License

MIT