1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with resolv_conf
   • What resolv_conf affects
   • Setup requirements
   • Beginning with resolv_conf
4. Usage - Configuration options and additional functionality
5. Reference - An under-the-hood peek at what the module is doing and how
6. Development - Guide for contributing to the module

Manage the /etc/resolv.conf on Linux and FreeBSD.

The module manages the DNS resolver configuration file. It allows setting the values for the nameserver, search, sortlist and options configuration settings. The following restrictions are enforced by the module:

• Up to 3 name servers may be listed.
• Up to 6 items may be included in the search list.
• Up to 10 items may be included in the sortlist.

The module creates and manages the content of the /etc/resolv.conf file. This affects the way the host is able to map hostname to IP addresses and vice versa.

The module uses the Puppet stdlib module.

Declare the class to create a configuration that uses only a local name server on 127.0.0.1.

class { 'resolv_conf': }

You can use class parameters to use a customized configuration.

class { 'resolv_conf':
  nameservers => [ '9.9.9.9', ],
}

You can also use Hiera to create this configuration.

resolv_conf::nameservers:
  - '9.9.9.9'

The following configuration will configure a remote name server and use the name of the local domain when unqualified hostnames are queried.

class { 'resolv_conf':
  nameservers => [ '9.9.9.9', ],
  searchlist  => [ $facts['networking']['domain'] ],
}

If your host is based in the example.net domain, then a lookup for the hostname server will query the name server for server.example.net.

This setup creates a configuration file with the given name servers and will also set additional options to enable name server rotation and set a specific timeout.

class { 'resolv_conf':
  nameservers => [ '8.8.8.8', '8.8.4.4', ],
  options     => [ 'rotate', 'timeout:2', ],
}

The following setup will create a configuration where the name server at 127.0.0.1 is queried first and only then the additional name servers are used.

class { 'resolv_conf':
  nameservers              => [ '8.8.8.8', '8.8.4.4', ],
  prepend_local_nameserver => true,
}

Note: This module does not configure a local name server that will answer queries on 127.0.0.1. You will have to use a different Puppet module to manage the name server.

See REFERENCE.md

You may open Github issues for this module if you need additional options currently not available.

Feel free to send pull requests for new features.