summaryrefslogtreecommitdiff
path: root/README.md
blob: c57dcff3162f363c4d8d1c76949b2902ff2a72b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
resolv.conf Puppet module
=========================

This module will manage `/etc/resolv.conf` through Puppet.

resolvconf class
----------------

The main class (`resolvconf`) takes a simple list of nameservers as an
array. For example:

    class { 'resolvconf':
        nameservers => [ '8.8.8.8' ],
    }

... will create a `resolv.conf` that searches the domain name of the
machine (the `$::domain` fact) and uses Google's recursive
nameservers. The domain name and search path can be overriden with the
`$domain` and `$search` parameters.

Extra options can be added at the end of the `resolv.conf` file with
the `$tail` argument.

resolvconf::dhcp class
----------------------

For machines that are configured with DHCP, the `resolvconf` class
should simply not be included, and the DHCP client will take care of
managing the config file.

However, if you wish to add options to the resulting `resolv.conf`
file, you can use the `resolvconf::dhcp` class that will use the
`resolvconf` Debian package to apply extra options at the end of the
`resolv.conf` file. For example, this will ensure a faster fallback
in case of failures in the DHCP-provided nameservers:

    class { 'resolvconf::dhcp':
        tail => 'options timeout:1 attempts:3 rotate',
    }