puppet-module-dnsclient

Table of Contents

1. Module Description - What the module does and why it is useful
2. Setup - The basics of getting started with dnsclient
   • What dnsclient affects
   • Setup requirements
   • Beginning with dnsclient
3. Usage - Configuration options and additional functionality
4. Limitations - OS compatibility, etc.
5. 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:

• nameservers
• options
• search
• domain
• sortlist
• resolver_config_file
• resolver_config_file_ensure
• resolver_config_file_owner
• resolver_config_file_group
• resolver_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)

Full Changelog

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