Defined Type: nsd::zone

Defined in:
manifests/zone.pp

Overview

Define a zone in NSD.

Examples:

Create a master zone

::nsd::zone { 'example.com.':
  source => 'puppet:///data/example.com.zone',
}

Create a slave zone that accepts notifies from the master

::nsd::zone { 'example.com.':
  allow_notify => [
    ['192.0.2.1', 'NOKEY'],
  ],
  request_xfr  => [
    ['192.0.2.1', 'NOKEY'],
  ],
}

Parameters:

  • zone (Bodgitlib::Zone) (defaults to: $title)
  • content (Optional[String]) (defaults to: undef)
  • source (Optional[String]) (defaults to: undef)
  • allow_notify (Optional[Array[NSD::ACL::AllowNotify, 1]]) (defaults to: undef)
  • allow_axfr_fallback (Optional[Boolean]) (defaults to: undef)
  • include_pattern (Optional[String]) (defaults to: undef)
  • notifies (Optional[Array[NSD::ACL::Notify, 1]]) (defaults to: undef)
  • notify_retry (Optional[Integer[0]]) (defaults to: undef)
  • outgoing_interface (Optional[NSD::Interface]) (defaults to: undef)
  • provide_xfr (Optional[Array[NSD::ACL::ProvideXFR, 1]]) (defaults to: undef)
  • request_xfr (Optional[Array[NSD::ACL::RequestXFR, 1]]) (defaults to: undef)
  • rrl_whitelist (Optional[Array[NSD::RRLType, 1]]) (defaults to: undef)
  • zonestats (Optional[String]) (defaults to: undef)

See Also:



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
 
# File 'manifests/zone.pp', line 35

define nsd::zone (
  Bodgitlib::Zone                           $zone                = $title,
  Optional[String]                          $content             = undef,
  Optional[String]                          $source              = undef,
  Optional[Array[NSD::ACL::AllowNotify, 1]] $allow_notify        = undef,
  Optional[Boolean]                         $allow_axfr_fallback = undef,
  Optional[String]                          $include_pattern     = undef,
  Optional[Array[NSD::ACL::Notify, 1]]      $notifies            = undef, # Renamed to avoid clash with notify metaparameter
  Optional[Integer[0]]                      $notify_retry        = undef,
  Optional[NSD::Interface]                  $outgoing_interface  = undef,
  Optional[Array[NSD::ACL::ProvideXFR, 1]]  $provide_xfr         = undef,
  Optional[Array[NSD::ACL::RequestXFR, 1]]  $request_xfr         = undef,
  Optional[Array[NSD::RRLType, 1]]          $rrl_whitelist       = undef,
  Optional[String]                          $zonestats           = undef,
) {

  if ! defined(Class['::nsd']) {
    fail('You must include the nsd base class before using any nsd defined resources')
  }

  if $content and $source {
    fail("You must provide either 'content' or 'source', they are mutually exclusive")
  }

  $_allow_notify = $allow_notify ? {
    undef   => undef,
    default => delete_undef_values($allow_notify.map |$acl| { nsd::flatten_acl($acl) }),
  }

  $_notifies = $notifies ? {
    undef   => undef,
    default => delete_undef_values($notifies.map |$acl| { nsd::flatten_acl($acl) }),
  }

  $_provide_xfr = $provide_xfr ? {
    undef   => undef,
    default => delete_undef_values($provide_xfr.map |$acl| { nsd::flatten_acl($acl) }),
  }

  $_request_xfr = $request_xfr ? {
    undef   => undef,
    default => delete_undef_values($request_xfr.map |$acl| { nsd::flatten_acl($acl) }),
  }

  $_title = "nsd zone ${zone}"

  $_filename = $zone[-1] ? {
    '.'     => "${zone[0, -2]}.zone",
    default => "${zone}.zone",
  }

  if $content or $source {
    $zonefile = "master/${_filename}"

    file { "${::nsd::zonesdir}/${zonefile}":
      ensure       => file,
      owner        => 0,
      group        => 0,
      mode         => '0644',
      content      => $content,
      source       => $source,
      validate_cmd => "/usr/sbin/nsd-checkzone ${zone} %",
      before       => ::Concat["${::nsd::conf_dir}/nsd.conf"],
    }
  } else {
    $zonefile = "slave/${_filename}"
  }

  ::concat::fragment { $_title:
    content => template("${module_name}/zone.erb"),
    order   => '30',
    target  => "${::nsd::conf_dir}/nsd.conf",
  }
}