debops.resolvconf

The /etc/resolv.conf configuration file defines the system-wide DNS resolver configuration. It is a central location to configure the DNS nameservers, search domains and other options. In modern Linux systems, many services might want to change that configuration file to enable their functionality - NetworkManager, ifupdown, dnsmasq, unbound being several examples of that.

To avoid clashes between various software packages modifying the /etc/resolv.conf file, the resolvconf package provides a stable API to the /etc/resolv.conf that combines information from other services and creates a consistent resolver configuration.

The debops.resolvconf Ansible role further updates the resolvconf configuration to fix issues with outdated defaults on modern Debian/Ubuntu hosts. By default the role will update the interface order list to include the Predictable Network Interface Names as well as clarify the order of the NetworkManager interfaces. The role will also automatically rearrange the configuration of VPN tunnels if a local DNS resolver is detected.

Contrary to its name, the debops.resolvconf role does not configure the /etc/resolv.conf file directly. You should consult the documentation of various DNS-related services to see how you can modify the contents of this file through them.

• Getting started
  • Support for static configuration
  • Example inventory
  • Example playbook
  • Ansible tags
  • Other resources
• debops.resolvconf default variables
  • Role configuration
  • APT packages
  • Static DNS configuration
  • Network interface order
  • Local DNS services
• Default variable details
  • resolvconf__interface_order

Copyright

debops.resolvconf - Configure systemw-wide DNS resolver via Ansible

Copyright (C) 2019 Maciej Delmanowski <drybjed@gmail.com>
Copyright (C) 2019 DebOps <https://debops.org/>
SPDX-License-Identifier: GPL-3.0-only

This Ansible role is part of DebOps.

DebOps is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License version 3, as
published by the Free Software Foundation.

DebOps is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with DebOps. If not, see https://www.gnu.org/licenses/.