cookbook 'resolvconf', '= 0.1.0', :supermarket
resolvconf (15) Versions 0.1.0 Follow6
Installs/Configures resolvconf
cookbook 'resolvconf', '= 0.1.0'
knife supermarket install resolvconf
knife supermarket download resolvconf
resolvconf Cookbook
This cookbook maintains /etc/resolv.conf using the resolvconf package, which is installed by default on Debian/Ubuntu.
Requirements
A system that supports resolvconf.
- Ubuntu >= 10.04
- Debian >= 6.0
Furthermore you need to add the following line to your metadata.rb
depends 'resolvconf'
Attributes
<table> <tr> <th>Key</th> <th>Type</th> <th>Description</th> <th>Default</th> </tr> <tr> <td><tt>['resolvconf']['nameserver']</tt></td> <td>String, Array</td> <td>Nameserver(s) to use</td> <td>OpenDNS Nameservers: <tt>[ '208.67.222.222', '208.67.220.220' ]</tt></td> </tr> <tr> <td><tt>['resolvconf']['search']</tt></td> <td>String, Array</td> <td>Domain(s) to add to search</td> <td><tt>node['domain']</tt></td> </tr> <tr> <td><tt>['resolvconf']['options']</tt></td> <td>String, Array</td> <td>Other options, e.g. 'rotate'</td> <td><tt>[]</tt></td> </tr>
<tr> <td><tt>['resolvconf']['head']</tt></td> <td>String, Array</td> <td>String(s) to be placed at the top of /etc/resolv.conf, typically a warning</td> <td><tt>[ '# Dynamic resolv.conf(5) file for glibc resolver(3) generated by resolvconf(8)', '# DO NOT EDIT THIS FILE BY HAND -- YOUR CHANGES WILL BE OVERWRITTEN' ]</tt></td> </tr> <tr> <td><tt>['resolvconf']['base']</tt></td> <td>String, Array</td> <td>String(s) to be placed in the of /etc/resolv.conf, typically configuration like nameserver, search, options</td> <td><tt>[]</tt></td> </tr> <tr> <td><tt>['resolvconf']['tail']</tt></td> <td>String, Array</td> <td>String(s) to be placed at the bottom of /etc/resolv.conf</td> <td><tt>[]</tt></td> </tr>
<tr> <td><tt>['resolvconf']['clear-dns-from-interfaces']</tt></td> <td>Boolean</td> <td>Remove dns-* settings from /etc/network/interfaces, as they might interferre with the configured settings</td> <td><tt>true</tt></td> </tr> </table>
Provider
resolvconf
The LWRP basically supports all options that can be set via attributes, and uses the same defaults. It will do the following
- It will create the necessary files in /etc/resolvconf/resolv.conf.d/
- Remove dns-* lines from /etc/network/interfaces (unless clear_dns_form_interfaces is specified)
- Run 'resolvconf -u'
Example:
resolvconf 'default'
resolvconf 'custom' do
nameserver '8.8.8.8'
search 'mydomain.com'
options 'rotate'
head "# Don't touch this configuration file!"
base "# Will be added after nameserver, search, options config items"
tail "# This goes to the end of the file."
# do not touch my interface configuration plz!
clear_dns_from_interfaces false
end
Recipes
resolvconf:install
Installs the resolvconf package.
resolvconf::default
Includes resolvconf::install, then configures the node using the specified attributes / defaults.
Contributing
Contributions are very welcome!
- Fork the repository on Github
- Create a named feature branch (like
add_component_x
) - Write you change
- Write tests for your change (if applicable)
- Run the tests, ensuring they all pass
- Submit a Pull Request using Github
License and Authors
Authors: Chris Aumann me@chr4.org
License: GPLv3
Dependent cookbooks
This cookbook has no specified dependencies.