resolver Cookbook

Configures /etc/resolv.conf, unless the nameservers attribute is empty. Search will be excluded if empty.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org or come chat with us on the Chef Community Slack in #sous-chefs.

Requirements

Platforms

AIX
Debian/Ubuntu
RHEL/CentOS/Scientific/Amazon/Oracle
Fedora
FreeBSD/OpenBSD
macOS
Solaris
openSUSE / SUSE Enterprise

Chef

Chef 15.3+

Resources

Usage

It is recommended to create a project or organization specific wrapper cookbook and add the desired custom resources to the run list of a node.

Example of configuring a node with nameservers, a search list and a local domain.

resolver_config '/etc/resolv.conf' do
  nameservers ['1.1.1.1', '1.0.0.1']
  domain 'test.com'
  search ['test1.com', 'test2.com']
  options(
    'timeout' => 2
  )
end

The resulting /etc/resolv.conf will look like:

#
# Generated by Chef Infra for dokken
# Do NOT modify this file by hand, changes will be overwritten.
#

domain test.com
search test1.com test2.com
nameserver 1.1.1.1
nameserver 1.0.0.1
options timeout:2