From f132eb66318f5779bb88b179c46237dc3aaf8a46 Mon Sep 17 00:00:00 2001 From: Stonewall Jackson Date: Sat, 11 Feb 2023 09:30:29 -0500 Subject: dnsmasq: add docs --- roles/dnsmasq/README.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 roles/dnsmasq/README.md (limited to 'roles/dnsmasq') diff --git a/roles/dnsmasq/README.md b/roles/dnsmasq/README.md new file mode 100644 index 0000000..ed1716b --- /dev/null +++ b/roles/dnsmasq/README.md @@ -0,0 +1,41 @@ +dnsmasq +======= + +Description +----------- + +The `dnsmasq` role configures NetworkManager to use [dnsmasq](https://thekelleys.org.uk/dnsmasq/doc.html) +for local DNS caching. + + +Variables +--------- + +This role **accepts** the following variables: + +Variable | Default | Description +-------------------------|--------------------------|------------ +`dnsmasq_nameservers` | `{{ vlan.dns_servers }}` | Upstream DNS servers +`dnsmasq_searchdomain` | `{{ domain }}` | Default search domain +`dnsmasq_resolv_options` | `['rotate']` | List of `resolv.conf(5)` options +`dnsmasq_cache_size` | 1000 | Number of records to cache +`dnsmasq_negcache` | no | Enable caching of `NXDOMAIN` responses +`dnsmasq_all_servers` | yes | Query all nameservers simultaneously (first response wins) + + +Usage +----- + +Example playbook: + +````yaml +- name: configure local DNS caching + hosts: all + roles: + - role: dnsmasq + vars: + dnsmasq_nameservers: + - 10.10.10.1 + - 10.10.10.2 + dnsmasq_searchdomain: example.com +```` -- cgit