1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
|
# Manage an ISC BIND nameserver
#
# @param namedconf_path
# Path of the named config
# @param dnsdir
# Directory holding the named configs
# @param dns_server_package
# Name of the package to install
# @param rndckeypath
# Path of the RNDC key
# @param optionspath
# Path of the named options
# @param publicviewpath
# Path of the config file holding all the zones
# @param vardir
# Directory holding the variable or working files
# @param namedservicename
# Name of the service
# @param zonefilepath
# Directory containing zone files
# @param localzonepath
# File holding local zones like RFC1912 or RFC1918 files. The special value
# 'unmanaged' can be used if one plans to create custom RFC1912/RFC1918 zones
# via dns, where the inclusion of package-shipped zone files is not desired.
# @param defaultzonepath
# File holding some RFC1912 zone includes on systems like Debian.
# The special value 'unmanaged' can be used if one plans to create custom
# zones via dns, where the inclusion of package-shipped zone files is not
# desired.
# @param forward
# The forward option
# @param forwarders
# The forwarders option
# @param listen_on_v6
# The listen-on-v6 option
# @param recursion
# The recursion option
# @param allow_recursion
# The allow-recursion option
# @param allow_query
# The allow-query option
# @param empty_zones_enable
# The empty-zones-enable option
# @param dns_notify
# The notify option in named.conf
# @param dnssec_enable
# The dnssec-enable option
# @param dnssec_validation
# The dnssec-validation option
# @param namedconf_template
# The template to be used for named.conf
# @param acls
# Specify a hash of ACLs. Each key is the name of a network, and its value is
# an array of subnet strings.
# @param optionsconf_template
# The template to be used for options.conf
# @param controls
# Specify a hash of controls. Each key is the name of a network, and its
# value is a hash containing 'port' => integer, 'keys' => array and
# 'allowed_addresses' => array
# @param service_ensure
# The ensure attribute on the service
# @param service_enable
# Whether to enable the service (start at boot)
# @param additional_options
# Additional options
# @param additional_directives
# Additional directives. These are free form strings that allow for full
# customization. Use with caution.
# @param enable_views
# Flag to indicate bind views support. Will remove global zone configuration
# like localzonepath inclusion.
# @param zones
# A hash of zones to be created. See dns::zone for options.
# @param keys
# A hash of keys to be created. See dns::key for options.
#
# @see dns::zone
# @see dns::key
class dns (
Stdlib::Absolutepath $namedconf_path = $dns::params::namedconf_path,
Stdlib::Absolutepath $dnsdir = $dns::params::dnsdir,
String $dns_server_package = $dns::params::dns_server_package,
Stdlib::Absolutepath $rndckeypath = $dns::params::rndckeypath,
Stdlib::Absolutepath $optionspath = $dns::params::optionspath,
Stdlib::Absolutepath $publicviewpath = $dns::params::publicviewpath,
Stdlib::Absolutepath $vardir = $dns::params::vardir,
String $namedservicename = $dns::params::namedservicename,
Stdlib::Absolutepath $zonefilepath = $dns::params::zonefilepath,
Variant[Enum['unmanaged'], Stdlib::Absolutepath] $localzonepath = $dns::params::localzonepath,
Variant[Enum['unmanaged'], Stdlib::Absolutepath] $defaultzonepath = $dns::params::defaultzonepath,
Optional[Enum['only', 'first']] $forward = $dns::params::forward,
Array[String] $forwarders = $dns::params::forwarders,
Optional[Variant[String, Boolean]] $listen_on_v6 = $dns::params::listen_on_v6,
Enum['yes', 'no'] $recursion = $dns::params::recursion,
Array[String] $allow_recursion = $dns::params::allow_recursion,
Array[String] $allow_query = $dns::params::allow_query,
Enum[yes, no] $empty_zones_enable = $dns::params::empty_zones_enable,
Optional[Enum['yes', 'no', 'explicit']] $dns_notify = $dns::params::dns_notify,
Enum['yes', 'no'] $dnssec_enable = $dns::params::dnssec_enable,
Enum['yes', 'no', 'auto'] $dnssec_validation = $dns::params::dnssec_validation,
String $namedconf_template = $dns::params::namedconf_template,
Hash[String, Array[String]] $acls = $dns::params::acls,
String $optionsconf_template = $dns::params::optionsconf_template,
Hash[String, Hash[String, Data]] $controls = $dns::params::controls,
Variant[Enum['running', 'stopped'], Boolean] $service_ensure = $dns::params::service_ensure,
Boolean $service_enable = $dns::params::service_enable,
Hash[String, Data] $additional_options = $dns::params::additional_options,
Array[String] $additional_directives = $dns::params::additional_directives,
Boolean $enable_views = $dns::params::enable_views,
Hash[String, Hash] $zones = $dns::params::zones,
Hash[String, Hash] $keys = $dns::params::keys,
) inherits dns::params {
include dns::install
include dns::config
contain dns::service
Class['dns::install'] ~> Class['dns::config'] ~> Class['dns::service']
create_resources('dns::key', $keys)
create_resources('dns::zone', $zones)
}
|
