Ansible Role dnsmasq

This role helps you install and set up dnsmasq on your system.

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

Here's a simple example of how to use this role. It is pulled from molecule/default/converge.yml and is tested with every change.

---
- name: Converge
  hosts: all
  become: true
  gather_facts: true
  pre_tasks:
    - name: Update apt cache.
      apt: update_cache=true cache_valid_time=600
      when: ansible_os_family == 'Debian'

  roles:
    - role: buluma.dnsmasq

Before running the main playbook, the machine needs to be set up, usually done with molecule/default/prepare.yml:

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

  roles:
    - role: buluma.bootstrap

For a more detailed guide, check the full explanation and example.

Role Variables

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

---
# defaults file 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_filterwin2k: false
dnsmasq_strict_order: false
dnsmasq_no_resolv: false
dnsmasq_no_poll: false
dnsmasq_user: "{{ dnsmasq_set_user }}"
dnsmasq_group: "{{ dnsmasq_set_group }}"
dnsmasq_no_dhcp_interface: ""
dnsmasq_local_service: false
dnsmasq_bind_interfaces: false
dnsmasq_no_hosts: false
dnsmasq_expand_hosts: false
dnsmasq_enable_ra: false
dnsmasq_log_queries: false
dnsmasq_log_dhcp: false

Requirements

• You need the pip packages listed in requirements.txt.

State of Used Roles

To get your system ready, you can use these roles or set up your own way.

Requirement	GitHub	Version
buluma.bootstrap

Context

This role is part of a collection of roles that work well together. Check out the documentation of these roles for more information.

Here’s a visual of the related roles:

Compatibility

This role has been tested with the following container images:

You need Ansible version 2.12 or above to use this role.

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

Changelog

You can check the Role History for updates.

License

This role is licensed under Apache-2.0.

Author Information

Created by Shadow Walker.