https://github.com/sous-chefs/resolver
Development repository for the resolver cookbook
https://github.com/sous-chefs/resolver
chef chef-cookbook chef-resource hacktoberfest managed-by-terraform resolver
Last synced: about 1 month ago
JSON representation
Development repository for the resolver cookbook
- Host: GitHub
- URL: https://github.com/sous-chefs/resolver
- Owner: sous-chefs
- License: apache-2.0
- Created: 2012-03-14T18:19:12.000Z (about 13 years ago)
- Default Branch: main
- Last Pushed: 2024-05-02T08:43:48.000Z (about 1 year ago)
- Last Synced: 2024-10-29T20:19:42.932Z (7 months ago)
- Topics: chef, chef-cookbook, chef-resource, hacktoberfest, managed-by-terraform, resolver
- Language: Ruby
- Homepage: https://supermarket.chef.io/cookbooks/resolver
- Size: 217 KB
- Stars: 28
- Watchers: 48
- Forks: 52
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-chef - resolver - Configures ```/etc/resolv.conf``` via attributes. (Cookbooks / Network/Security)
README
# resolver Cookbook
[](https://supermarket.chef.io/cookbooks/resolver)
[](https://github.com/sous-chefs/resolver/actions?query=workflow%3Aci)
[](#backers)
[](#sponsors)
[](https://opensource.org/licenses/Apache-2.0)
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](documentation/resolver_config.md)
- [resolver_systemd_resolved_config](documentation/resolver_systemd_resolved_config.md)
## Usage
It is recommended to create a project or organization specific [wrapper cookbook](https://blog.chef.io/doing-wrapper-cookbooks-right) 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.
```ruby
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:
```text
#
# 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.](https://opencollective.com/sous-chefs/contributors.svg?width=890&button=false)
### 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.
