Skip to content
README.rst 1.53 KiB
Newer Older
nimrod's avatar
nimrod committed
Unbound
nimrod's avatar
nimrod committed
#######

.. image:: https://travis-ci.org/adarnimrod/example.svg?branch=master
    :target: https://travis-ci.org/adarnimrod/example

nimrod's avatar
nimrod committed
Provision the Unbound DNS resolver. The configuration from this role is log to
syslog, DNSSEC and use the conf.d directory. To add your own configuration, add
a template at :code:`template/unbound/conf.d/*.conf` either inside the role or
relative to your playbook.
nimrod's avatar
nimrod committed

Requirements
------------

See :code:`meta/main.yml` and assertions at the top of :code:`tasks/main.yml`.
nimrod's avatar
nimrod committed

Role Variables
--------------

See :code:`defaults/main.yml`.
nimrod's avatar
nimrod committed

Dependencies
------------

See :code:`meta/main.yml`.

Example Playbook
----------------

See :code:`tests/playbook.yml`.

Testing
-------

Testing requires Python 2.7 and either Docker or Vagrant and Virtualbox.
Install the Python dependencies, dependent roles and roles required for
testing:
nimrod's avatar
nimrod committed

.. code:: shell

    pip install -r tests/requirements.txt
    ansible-galaxy install git+file://$(pwd),$(git rev-parse --abbrev-ref HEAD) -p .molecule/roles
    molecule dependency
nimrod's avatar
nimrod committed

To run the full test suite:

.. code:: shell

    pre-commit run --all-files
    molecule test --platform all
nimrod's avatar
nimrod committed

License
-------

This software is licensed under the MIT license (see the :code:`LICENSE.txt`
file).

Author Information
------------------

Nimrod Adar, `contact me <nimrod@shore.co.il>`_ or visit my `website
<https://www.shore.co.il/>`_. Patches are welcome via `git send-email
<http://git-scm.com/book/en/v2/Git-Commands-Email>`_. The repository is located
nimrod's avatar
nimrod committed
at: https://git.shore.co.il/explore/.