Giter Club home page Giter Club logo

puppet-bind's Introduction

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]

puppet-bind's People

Contributors

sathieu avatar

Watchers

 avatar James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.