Ansible Role dns

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

GitHub	Version	Issues	Pull Requests	Downloads

Example Playbook

Here’s a simple playbook example from molecule/default/converge.yml that is tested with every update.

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

  roles:
    - role: buluma.dns
      dns_port: 5353

Before applying this role, you need to prepare the machine. In CI systems, this is done with molecule/default/prepare.yml:

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

  roles:
    - role: buluma.bootstrap
    - role: buluma.core_dependencies

You can find a more detailed guide and examples here.

Role Variables

Default values for the role variables are defined in defaults/main.yml:

---
# Defaults for DNS

# Port for listening.
dns_port: 53

# Use DNS server as caching server?
dns_caching_dns: true

# List of zones and their properties.
dns_zones:
  - name: localhost
    soa: localhost
    serial: 1
    refresh: 604800
    retry: 86400
    expire: 2419200
    ttl: 604800
    records:
      - name: "@"
        type: NS
        value: localhost.
      - name: "@"
        value: "127.0.0.1"
      - name: "@"
        type: AAAA
        value: "::1"

  # Additional zone examples follow...

Requirements

Make sure to install the pip packages listed in requirements.txt.

State of Used Roles

Some roles are needed to prepare the system. You can also use other methods.

Requirement	GitHub	Version
buluma.bootstrap
buluma.core_dependencies

Context

This role works along with many other roles. Check the documentation for these roles for more details.

Here's a look at related roles:

Compatibility

This role has been tested with the following container images:

Ansible version 2.12 or higher is required. Testing has been done on:

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

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

Changelog

For the history of changes, see here.

License

This role is licensed under Apache-2.0.

Author Information

Created by Shadow Walker.