DEBOPS.DHCRELAY(5)

NAME
debops.dhcrelay - Manage ISC DHCP Relay Agent using Ansible

SYNOPSIS

debops service/dhcrelay [--limit group,host,...] [--diff] [--check] [--tags tag1,tag2,...] [--skip-tags tag1,tag2,...] [<ansible-playbook options>] ...

DESCRIPTION

The debops.dhcrelay role can be used to configure dhcrelay, the Internet Systems Consortium DHCP Relay Agent. dhcrelay can be used to relay DHCPv4 messages between hosts on one network, and a DHCPv4 server on another network.

This role does not support DHCPv6, as DHCPv6 is currently not supported by the init script provided by the isc-dhcp-relay package in Debian Stable. A workaround for this can be implemented if there is demand for it.

GETTING STARTED

The default configuration of this role will install isc-dhcp-relay, configure it to listen on the internal network interface and forward requests to the default IPv4 gateway. A DHCP server should be running on the default IPv4 gateway; if not, you should change the dhcrelay__servers variable.

  Example playbook

If you are using this role without DebOps, here's an example Ansible playbook that uses the debops.dhcrelay role:

---
- name: Manage ISC DHCP relay
  collections: [ 'debops.debops', 'debops.roles01',
                 'debops.roles02', 'debops.roles03' ]
  hosts: [ 'debops_service_dhcrelay' ]
  become: True
  environment: '{{ inventory__environment | d({})
                   | combine(inventory__group_environment | d({}))
                   | combine(inventory__host_environment  | d({})) }}'
  roles:
    - role: dhcrelay
      tags: [ 'role::dhcrelay', 'skip::dhcrelay' ]

  Other resources

It is worth checking out the dhcrelay manpage: dhcrelay(8) <https://manpages.debian.org/dhcrelay(8)>.

COPYRIGHT
2014-2022, Maciej Delmanowski, Nick Janetakis, Robin Schneider and others