cookbook 'dns_caching', '~> 2.0.0'
dns_caching (3) Versions 2.0.0 Follow0
Installs dnsmasq to provide DNS caching
cookbook 'dns_caching', '~> 2.0.0', :supermarket
knife supermarket install dns_caching
knife supermarket download dns_caching
dns_caching
This cookbook installs and configures dnsmasq for local DNS caching. It relies on Chef's resolver cookbook to update /etc/resolv.conf on all systems except Ubuntu (which uses resolvconf.
Requirements
Platforms
- Ubuntu
- RHEL/CentOS
Attributes
In order for the cookbook to run, resolver attributes must be set to define DNS nameservers and search domains:
ruby
"resolver" => {
"nameservers" => ["10.13.37.120", "10.13.37.40"],
"search" => "int.example.org",
"options" => {
"timeout" => 2, "rotate" => nil
}
}
See the resolver cookbook for more details on the available attributes.
Usage
Create resolver attributes to define DNS nameservers and search domains. The first DNS nameserver defined must be the loopback interface address, usually 127.0.0.1. Once the dns_caching cookbook is assigned to a node and the resolver attributes are defined, the default recipe will install dnsmasq and use the resolver cookbook to update /etc/resolv.conf.
On Ubuntu systems, the resolver cookbook is not used and dnsmasq is configured to ignore /etc/resolv.conf and other configuration files created by the resolvconf package. It will use its own configuration for nameserver definitions instead. The resolvconf service will automatically update /etc/resolv.conf to direct DNS requests to dnsmasq once the package is installed.
Dependent cookbooks
| resolver ~> 1.3 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
dns_caching Cookbook CHANGELOG
This file is used to list changes made in each version of the dns_caching cookbook.
2.0.0 (2017-02-06)
- Added support for Ubuntu 16.04 and RHEL/CentOS 7
- Removed support for Ubuntu < 12.04
- Updated resolver cookbook dependency version
- Rubocop fixes and code cleanup
Collaborator Number Metric
2.0.0 passed this metric
Contributing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.0 passed this metric
No Binaries Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 passed this metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
2.0.0 passed this metric
No Binaries Metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 passed this metric
2.0.0 passed this metric
Testing File Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
2.0.0 failed this metric
2.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
