Ansible Role for dnsmasq

This guide explains how to install and set up dnsmasq on your system.

GitHub	GitLab	Downloads	Version

Example Playbook

Here’s a simple example to get you started, taken from molecule/default/converge.yml. It gets tested with every update.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true

  roles:
    - role: robertdebock.dnsmasq

Before running this, your machine needs to be set up first. This is done in CI using molecule/default/prepare.yml:

---
- name: Prepare
  hosts: all
  become: true
  gather_facts: false

  roles:
    - role: robertdebock.bootstrap

For more details on how to use these roles, check this link.

Role Variables

The default settings for the variables can be found in defaults/main.yml:

---
# defaults for dnsmasq
dnsmasq_domain_needed: false
dnsmasq_bogus_priv: false
dnsmasq_conf_file: "{{ dnsmasq_documentation_path }}/trust-anchors.conf"
dnsmasq_dnssec: false
dnsmasq_dnssec_check_unsigned: false
dnsmasq_user: "{{ dnsmasq_set_user }}"
dnsmasq_group: "{{ dnsmasq_set_group }}"
dnsmasq_no_dhcp_interface: ""
dnsmasq_local_service: false

Requirements

• Python packages listed in requirements.txt.

Used Roles

To prepare your system, the following roles are used. You can use different methods if you like.

Requirement	GitHub	GitLab
robertdebock.bootstrap

Context

This role works well with many other roles. For more information, see the documentation.

Here’s a visual of related roles:

Compatibility

This role has been tested with these container images:

The minimum version of Ansible required is 2.12. Tests have been performed on:

• The previous version.
• The current version.
• The development version.

If you encounter any issues, please report them on GitHub.

License

This project is licensed under Apache-2.0.

Author Information

This role is developed by robertdebock.

If you appreciate this work, consider sponsoring me.