2021-07-09 12:07:40 +02:00
[![Ansible Galaxy ](https://raw.githubusercontent.com/roles-ansible/ansible_role_unbound/main/.github/galaxy.svg?sanitize=true )](https://galaxy.ansible.com/do1jlr/unbound) [![MIT License ](https://raw.githubusercontent.com/roles-ansible/ansible_role_unbound/main/.github/license.svg?sanitize=true )](https://github.com/roles-ansible/ansible_role_unbound/blob/main/LICENSE)
2021-03-13 01:24:01 +01:00
Unbound DNS Resolver
======================
2018-03-10 19:20:54 +01:00
Ansible role to install and configure the `unbound` dns resolver.
Variables
---------
2021-03-13 01:24:01 +01:00
| variable | default | explaination |
| -------- | ------- | ------------ |
2021-07-16 19:53:55 +02:00
| ``unbound_listen_addresses`` | ``['127.0.0.1@53','::1@53']`` | define interfaces and ports where unbound should listen |
| ``unbound_access_control`` | ``['access-control: 127.0.0.1 allow', 'access-control: ::1 allow']`` | define access control |
| ``unbound__state`` | ``present`` | Package state. *(use ``latest`` for explicit update)*
| ``submodules_versioncheck`` | ``false`` | run basic versions check. ``true`` is recomended. |
2018-03-10 19:20:54 +01:00
2022-11-17 23:56:45 +01:00
For more options have a look into the defaults/main.yml file.
2021-03-13 01:24:01 +01:00
Files
-------
2018-03-15 03:19:45 +01:00
* `unbound.conf` :
Main unbound configuration file.
2019-09-18 00:46:03 +02:00
2021-03-13 01:24:01 +01:00
References
------------
2019-09-18 00:46:03 +02:00
* [Unbound Configuration ](https://nlnetlabs.nl/documentation/unbound/unbound.conf/ )
2021-03-13 22:36:03 +01:00
## Testing
This role is tested with some linting tests. Sadly I don't know how to run this role in a docker container because systemd is involved... If you have ideas how to improve testing please dend me a message, open a issue or Pull Request.
If you want to find out more about our tests, please have a look at the github marketplace.
| test status | Github Marketplace |
| :--------- | :---------------- |
| [![Galaxy release ](https://github.com/roles-ansible/ansible_role_unbound/actions/workflows/galaxy.yml/badge.svg )](https://github.com/roles-ansible/ansible_role_unbound/actions/workflows/galaxy.yml) | [publish-ansible-role-to-galaxy ](https://github.com/marketplace/actions/publish-ansible-role-to-galaxy ) |
| [![Yamllint GitHub Actions ](https://github.com/roles-ansible/ansible_role_unbound/actions/workflows/yamllint.yaml/badge.svg )](https://github.com/roles-ansible/ansible_role_unbound/actions/workflows/yamllint.yaml) | [yamllint-github-action ](https://github.com/marketplace/actions/yamllint-github-action ) |
| [![Ansible Lint check ](https://github.com/roles-ansible/ansible_role_unbound/actions/workflows/ansible-linting-check.yml/badge.svg )](https://github.com/roles-ansible/ansible_role_unbound/actions/workflows/ansible-linting-check.yml) | [ansible-lint action ](https://github.com/marketplace/actions/ansible-lint )