GitXplorerGitXplorer
s

puppet-bind

public
0 stars
0 forks
0 issues

Commits

List of commits on branch master.
Unverified
4297d9587cca9d0b01adf1d0490818dcd73d998b

Initial view support

ssathieu committed 12 years ago
Unverified
66bcd3956aabc114b72883d105dd2b644f18cee0

Move concat part to subclass

ssathieu committed 12 years ago
Unverified
5e9634583d37e4211649ed28676e86491adf5ab0

Initial support for zone files

ssathieu committed 12 years ago
Unverified
07bfea35704ab04c6edf148a80dcd3e329ed9d1d

Ignore gedit backup files

ssathieu committed 12 years ago
Unverified
ed4e793627cc87c675c8875f298cba0f54059c69

Concat as no $ensure, workaround

ssathieu committed 12 years ago
Unverified
81d279390bf21d6bc5b68f9e33bea899a509b6b8

Manage config using concat

ssathieu committed 12 years ago

README

The README file for this repository.

Puppet module: bind

This is a Puppet module for bind based on the second generation layout ("NextGen") of Example42 Puppet Modules.

Made by Mathieu Parent, based on Example42 template from Alessandro Franceschi / Lab42

Official site: http://www.example42.com

Official git repository: http://github.com/example42/puppet-bind

Released under the terms of Apache 2 License.

This module requires functions provided by the Example42 Puppi module (you need it even if you don't use and install Puppi)

For detailed info about the logic and usage patterns of Example42 modules check the DOCS directory on Example42 main modules set.

USAGE - Basic management

  • Install bind with default settings

      class { 'bind': }
    
  • This module implements most of the usual example42 parameters (version, disable, absent, audit_only, noops, source, template, my_class, puppi*, monitor*, firewall* ...)

  • By default, the configuration in split in several files :

    • named.conf: main configuration file, loading named.conf.options and named.conf.local
    • named.conf.options: the 'options' statement
    • named.conf.local: views and zone
  • You can set bind options:

      class {
        'bind':
          options             => {
            'dnssec-validation' => 'auto',
            'auth-nxdomain'     =>  'no',
            'listen-on-v6'      => [ 'any' ],
          };
      }
    

USAGE - Views and zones

  • By default, a view named zzz_default is created. To disable this feature:

      class {
        'bind':
          create_default_view => false;
      }
    
  • A complete example with some views, zones and record:

      # We create our own views:
      class {
        'bind':
          create_default_view => false,
          forwarders          => [
            '10.2.3.4',
            '10.3.4.5',
          ];
      }
    
      # A private and a public view (mind sort order!)
      bind::view {
        'private':
          match_clients        => '10.0.0.0/8',
          match_destinations   => 'any',
          match_recursive_only => false,
      }
      bind::view {
        'zz_public':
          match_clients        => 'any',
          match_destinations   => 'any',
          match_recursive_only => false,
      }
    
      # Use the 'exported resource' template:
      Bind::Zone {
        zonefile_template => 'bind/zonefile.erb',
      }
    
      bind::zone {
        'priv_example.org':
          zonename => 'example.org',
          view     => 'private',
          masters  => [
            'ns1.example.org',
            'ns2.example.com',
            'ns3.example.com',
          ],
          options  => {
            'allow-transfer' => [ '10.2.3.4', '10.3.4.5' ],
            'allow-query'    => 'any',
          },
        'pub_example.org':
          zonename => 'example.org',
          view     => 'zz_public',
          masters  => [
            'ns1.example.org',
            'ns2.example.com',
            'ns3.example.com',
          ],
          options  => {
            'allow-transfer' => [ '10.2.3.4', '10.3.4.5' ],
            'allow-query'    => 'any',
          },
      }
    
      Bind::Record {
        zonename => 'example.org',
        view     => 'zz_public',
      }
      @@bind::record {
        'pub_example.org_mx':
          lines    => '@ IN MX 10 smtp1';
        'pub_example.org_somehosts':
          lines    => [
            'ns1   IN A 10.1.2.3',
            'stmp1 IN A 10.9.8.7',
          ]
      }
      @@bind::host {
        'priv_ns1.example.org':
          zonename => 'example.org',
          view     => 'zz_public',
          hostname => 'ns1',
          ips      => [ '192.168.1.2' ],
          cnames   => [ 'dns1' ],
      }
    

CONTINUOUS TESTING

Travis {Build Status}[https://travis-ci.org/example42/puppet-bind]