Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ricsanfre/ansible-role-dnsmasq
Install and configure lightweight DHCP and DNS server, dnsmasq, on Linux.
https://github.com/ricsanfre/ansible-role-dnsmasq
ansible dnsmasq linux role system
Last synced: about 1 month ago
JSON representation
Install and configure lightweight DHCP and DNS server, dnsmasq, on Linux.
- Host: GitHub
- URL: https://github.com/ricsanfre/ansible-role-dnsmasq
- Owner: ricsanfre
- License: mit
- Created: 2021-08-14T10:52:20.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2023-06-03T09:49:22.000Z (over 1 year ago)
- Last Synced: 2024-10-13T22:51:16.270Z (3 months ago)
- Topics: ansible, dnsmasq, linux, role, system
- Language: Jinja
- Homepage: https://galaxy.ansible.com/ricsanfre/dnsmasq
- Size: 20.5 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Ansible Role: dnsmasq
=========
[](https://github.com/ricsanfre/ansible-role-dnsmasq/actions/workflows/ci.yml)
Install and configure lightweight DHCP and DNS server, dnsmasq, on Linux.
Requirements
------------
None.
Role Variables
--------------
Available variables are listed below along with default values (see `defaults\main.yaml`)
Host interface and IP where Dnsmasq is listening:
```yml
dnsmasq_interface: ''
dnsmasq_listen_address: ''
```
> Default values are null. Role get interface and ip information from gathered facts.
> In case that the server has more than one interface, specify values for these variables
Local domain name:
```yml
dnsmasq_domain_name: example.ricsanfre.com
```
DNS upstream servers (for relaying DNS queries):
```yml
dnsmasq_upstream_dns_servers:
- 80.58.61.250
- 80.58.61.254
```
DHCP lease IP range:
```yml
dnsmasq_dhcp_range: '10.0.0.32,10.0.0.128'
```
Discovery DHCP and DNS
```yml
dnsmasq_dicover_inventory: true
```
If setting to true, DHCP and DNS records are added from the hosts within inventory (any host = `all` group)
Variables: `ip`, `mac` and `hostname` need to be added to the hosts in the inventory:
```yml
hosts:
all:
children:
cluster:
hosts:
server1:
hostname: server1
ip: 10.0.0.11
mac: dc:a6:32:9c:29:b9
server2:
hostname: server2
ip: 10.0.0.12
mac: e4:5f:01:2d:fd:19
server3:
hostname: server3
ip: 10.0.0.13
mac: e4:5f:01:2f:49:05
```
Additional DHCP and DNS records can be added with the following variables:
```yml
dnsmasq_additional_dhcp_hosts: {}
```
```yml
dnsmasq_additional_dhcp_hosts:
ethernet_switch:
desc: "Ethernet Switch"
mac: 94:a6:7e:7c:c7:69
ip: 10.0.0.2
```
```yml
dnsmasq_additional_dns_hosts: {}
```
```yml
dnsmasq_additional_dns_hosts:
ntp_server:
desc: "NTP Server"
hostname: ntp
ip: 10.0.0.1
dns_server:
desc: "DNS Server"
hostname: dns
ip: 10.0.0.1
```
Enable TFTP service and specify TFTP root directory
```yml
dnsmasq_enable_tftp: false
dnsmasq_tftp_root: /srv/tftp
```
Additional configuration can be specified, added at the end of the dnsmasq config file
```yml
dnsmasq_additional_conf: []
```
```yml
dnsmasq_additional_conf: |-
# Enabling Netboot
dhcp-boot=pxelinux.0
dhcp-match=set:efi-x86_64,option:client-arch,7
dhcp-boot=tag:efi-x86_64,bootx64.efi
```
Dependencies
------------
None
Example Playbook
----------------
```yml
---
- name: Dnsmasq
hosts: host
vars:
- additional_dhcp_hosts:
ethernet_switch:
desc: "Ethernet Switch"
mac: 94:a6:7e:7c:c7:69
ip: 10.0.0.2
- additional_dns_hosts:
ntp_server:
desc: "NTP Server"
hostname: ntp
ip: 10.0.0.1
dns_server:
desc: "DNS Server"
hostname: dns
ip: 10.0.0.1
roles:
- role: ricsanfre.dnsmasq
```
License
-------
MIT/BSD
Author Information
------------------
Ricardo Sanchez (ricsanfre)