blob: 9ed93f63ea5c41aadb465c6535c0cd924c1488da (
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
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
(also the default). 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. (Note that the `$tail` name was chosen because
`options` is Linux-specific and will vary on different platforms.)
A more complete example:
class { 'resolvconf':
nameservers => [ '8.8.8.8' ],
domain => 'example.com',
search => 'office.example.com bar.example.com',
tail => 'options timeout:1 attempts:3 rotate',
}
See the `resolv.conf(5)` manpage for more information about those
parameters and the syntax of the resolv.conf file.
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',
}
License
-------
This program 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.
|