GitXplorerGitXplorer
s

puppet-bind

public
0 stars
0 forks
0 issues

Commits

List of commits on branch master.
Unverified
82256e03887fef45a2f2b637c1d2ce9152257111

Load concat for named.conf

ssathieu committed 12 years ago
Unverified
a2ca6bf428b745920e58d753065f6a18bda9414e

check for $bind::manage_config_file_local (requirement for views), and fix reference to removed class

ssathieu committed 12 years ago
Unverified
20d43832ef9e357b2563596057d0443d794615b2

Enforce boolean values, check for $bind::manage_config_file_local (requirement for zones), and fix reference to removed class

ssathieu committed 12 years ago
Unverified
3bb3a9845d66725385b903e3011ef2332113d86c

Move to split configuration

ssathieu committed 12 years ago
Unverified
621072e2bc491a624ce03b667c306cbd9c5debab

Remove source_dir support

ssathieu committed 12 years ago
Unverified
2ba17e704651f38f19db6d41dc7fde14c1c0cf61

Separate config files

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]