README.md

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

• resolver_config
• resolver_systemd_resolved_config

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

Contributors

This project exists thanks to all the people who contribute.

Backers

Thank you to all our backers!

Sponsors

Support this project by becoming a sponsor. Your logo will show up here with a link to your website.