mrlesmithjr / ansible-isc-dhcp

ansible-isc-dhcp

An Ansible role to install/configure ISC-DHCP server(s)

• Configurable options
• Failover and load balancing ready

Requirements

Scopes

Define your DHCP Scopes

isc_dhcp_scopes:
  - subnet: 192.168.250.0
    default_lease_time: "{{ isc_dhcp_default_lease_time }}"
    max_lease_time: "{{ isc_dhcp_max_lease_time }}"
    netmask: 255.255.255.0
    # Define scope specific options to configure
    options:
      - name: routers
        value: 192.168.250.1
      - name: subnet-mask
        value: 255.255.255.0
      - name: broadcast-address
        value: 192.168.250.255
      - name: domain-name-servers
        value: "{{ isc_dhcp_name_servers|join (', ') }}"
    range_start: 192.168.250.128
    range_end: 192.168.250.224

Failover scopes

For failover define the following vars to fit your deployment...

isc_dhcp_failover_info:
  # ansible_default_ipv4.address|ansible_enp0s8.ipv4.address
  # Defines failover address for dhcp failover setup
  failover_address: "{{ ansible_default_ipv4.address }}"
  # Define Ansible inventory group that nodes belong to
  failover_group: dhcp-nodes
  # Define the node in which should be considered the primary
  primary: "{{ groups['dhcp-nodes'][0] }}"
  # Define the port to be used on primary node
  primary_port: "519"
  # Define the node in which should be considered the secondary
  secondary: "{{ groups['dhcp-nodes'][1] }}"
  # Define the port to be used on secondary node
  secondary_port: "520"

Role Variables

defaults/main.yml

Dependencies

None

Example Playbook

---
- hosts: dhcp-nodes
  vars:
    isc_dhcp_scopes:
      - subnet: 192.168.250.0
        default_lease_time: "{{ isc_dhcp_default_lease_time }}"
        max_lease_time: "{{ isc_dhcp_max_lease_time }}"
        netmask: 255.255.255.0
        # Define scope specific options to configure
        options:
          - name: routers
            value: 192.168.250.1
          - name: subnet-mask
            value: 255.255.255.0
          - name: broadcast-address
            value: 192.168.250.255
          - name: domain-name-servers
            value: "{{ isc_dhcp_name_servers|join (', ') }}"
        range_start: 192.168.250.128
        range_end: 192.168.250.224
  roles:
    - role: ansible-isc-dhcp

License

MIT

Author Information

Larry Smith Jr.

• EverythingShouldBeVirtual
• @mrlesmithjr
• mailto:[email protected]

ansible-isc-dhcp's Issues

Refactor code

Need to cleanup variables/tasks.

Add abuility to modify interfaces in /etc/default/isc-dhcp-server

Need ability to modify the /etc/default/isc-dhcp-server file to use different interfaces.

Failover ports blocked by SELinux

On CentOS 7, the failover ports (519 and 520) are blocked by SELinux. If you don't set the ports (and the upstream defaults (647, 847) are used, it works out of the box. A solution would be to either default to the upstream defaults or make the ports configurable.

See also https://www.centos.org/forums/viewtopic.php?t=54348

Ability to pass variables to playbooks from CSV at commandline

I am looking for a way to pass all IP and host information from a variable file which would be loaded at run time. This file would be loaded when the playbook is run. so the command would be "ansible-playbook buildPi.yml PiList.csv" The buildPi.yml is the playbook which has the individual playbooks to install the various packages needed on the Raspberry Pi. The PiList.csv would be a CSV variable list of the hostnames, IP addresses and Networks for each item needed in the playbooks. That way we don't have to go in and change any of the playlists and run the risk of breaking them.