Version information
This version is compatible with:
- Puppet Enterprise 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x
- Puppet >= 6.0.0 < 8.0.0
- , , , , , , SLES, SLED,
Start using this module
Add this module to your Puppetfile:
mod 'ghoneycutt-dnsclient', '4.1.0'Learn more about managing modules with a PuppetfileDocumentation
puppet-module-dnsclient
Table of Contents
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with dnsclient
- Usage - Configuration options and additional functionality
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
Module description
This module manages /etc/resolv.conf and its various options. It is
feature complete for the supported platforms.
Documented with puppet-strings
Setup
What dnsclient affects
Manages the system resolver, /etc/resolv.conf.
Setup requirements
This module requires stdlib.
Beginning with dnsclient
Include the dnsclient class and it will configure the resolver to use
Google's public name servers.
Usage
Minimal and normal usage. See the examples directory for more usage examples.
include dnsclient
Limitations
This module has been tested to work on the following systems with Puppet
versions 6 and 7 with the Ruby version associated with those releases.
Please see .travis.yml for a full matrix of supported versions. This
module aims to support the current and previous major Puppet versions.
- EL 5
- EL 6
- EL 7
- EL 8
- Debian 6
- SLES 10
- SLES 11
- Solaris 10
- Ubuntu 10.04 LTS (Lucid Lynx)
- Ubuntu 12.04 LTS (Precise Pangolin)
Development
See CONTRIBUTING.md for information related to the development of this
module.
Reference
Table of Contents
Classes
dnsclient: Manage DNS resolver
Classes
dnsclient
This module manages /etc/resolv.conf.
Parameters
The following parameters are available in the dnsclient class:
nameserversoptionssearchdomainsortlistresolver_config_fileresolver_config_file_ensureresolver_config_file_ownerresolver_config_file_groupresolver_config_file_mode
nameservers
Data type: Array[Stdlib::IP::Address]
Array of nameservers. The default use Google's public name servers.
Default value: ['8.8.8.8', '8.8.4.4']
options
Data type: Array
Array of options. Set to [] if no options line should be present.
Default value: ['rotate', 'timeout:1']
search
Data type: Optional[Array[String[1]]]
Optional array of domains for search list. This is mutually exclusive with domain.
Default value: undef
domain
Data type: Optional[Stdlib::Fqdn]
Optional domain setting. This is mutually exclusive with search.
Default value: undef
sortlist
Data type: Optional[Array[String[1]]]
Optional array of sortlist entries
Default value: undef
resolver_config_file
Data type: Stdlib::Absolutepath
Path to resolv.conf
Default value: '/etc/resolv.conf'
resolver_config_file_ensure
Data type: String[1]
Value of ensure attribute for the /etc/resolv.conf file resource
Default value: 'file'
resolver_config_file_owner
Data type: String[1]
User of /etc/resolv.conf
Default value: 'root'
resolver_config_file_group
Data type: String[1]
Group of /etc/resolv.conf
Default value: 'root'
resolver_config_file_mode
Data type: Stdlib::Filemode
Mode of /etc/resolv.conf in octal format
Default value: '0644'
Changelog
v4.0.0 (2021-04-19)
Merged Pull Requests
- Modernize #40 (ghoneycutt)
- Remove EOL Puppet Versions #39 (BuJo)
3.6.0 - 2018-12-08
- Support Puppet versions 5 and 6.
3.5.2 - 2016-10-12
- Explicitly support puppet-lint v2
3.5.1 - 2016-08-31
- No changes, just another release to appease an issue with the Forge.
3.5.0 - 2016-08-31
- Add support for Ruby v2.3.1
3.4.0 - 2015-05-27
- Support Puppet v4 and v3 with future parser
3.0.4 - 2013-06-08 Garrett Honeycutt code@garretthoneycutt.com
- Fix warnings by using @ in front of variables in template
- .fixtures.yml is tracking correct version of puppetlabs/stdlib
- Drop Puppet v2.6 from travis-ci
- anders-larsson updates README to document support for SLES 10
- anders-larsson updates README to document support for all EL, not just CentOS
3.0.1 - 2013-03-16 Garrett Honeycutt code@garretthoneycutt.com
- fixed spec bug relating to lack of .fixtures.yml
- cleaned up testing framework
3.0.0 - 2013-03-16 Garrett Honeycutt code@garretthoneycutt.com
- Switched to semantic versioning - http://semver.org
- Implemented new design pattern that manages data with Hiera
- Truly portable module! Code is completely data driven, so you can make changes through Hiera and never have to edit the code itself.
2.0.0 - 2011-09-09 Garrett Honeycutt garrett@puppetlabs.com
- Implemented design pattern based on http://www.puppetlabs.com/blog/design-pattern-for-dealing-with-data/
1.0.1 - 2010-09-24 Garrett Honeycutt code@garretthoneycutt.com
- Added documentation
1.0.0 - 2010-06-24 Garrett Honeycutt code@garretthoneycutt.com
- Initial release
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 6.0.0 < 8.0.0)
Copyright (C) 2010-2016 Garrett Honeycutt <code@garretthoneycutt.com>
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.