https://github.com/ghoneycutt/puppet-module-bind

Puppet module to manage bind
https://github.com/ghoneycutt/puppet-module-bind

bind bind9 dns puppet puppet-module

Last synced: 3 months ago
JSON representation

Puppet module to manage bind

Host: GitHub
URL: https://github.com/ghoneycutt/puppet-module-bind
Owner: ghoneycutt
License: other
Created: 2016-05-26T14:07:57.000Z (about 9 years ago)
Default Branch: master
Last Pushed: 2017-11-22T21:34:42.000Z (over 7 years ago)
Last Synced: 2025-04-11T00:44:14.904Z (3 months ago)
Topics: bind, bind9, dns, puppet, puppet-module
Language: Ruby
Size: 104 KB
Stars: 1
Watchers: 2
Forks: 4
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE

Awesome Lists containing this project

README

# puppet-module-bind

#### Table of Contents

1. [Module Description](#module-description)
2. [Compatibility](#compatibility)
3. [Class Descriptions](#class-descriptions)
* [bind](#class-bind)
4. [Define Descriptions](#define-descriptions)
* [bind::acl](#defined-type-bindacl)
* [bind::channel](#defined-type-bindchannel)
* [bind::key](#defined-type-bindkey)
* [bind::masters](#defined-type-bindmasters)
* [bind::view](#defined-type-bindview)
* [bind::zone](#defined-type-bindzone)

# Module description

Manage ISC Bind 9. This module's approach is to manage the configuration of
bind9 while not managing the data in the actual zones, which is up to you.
Recommend keeping zone data in another repo and having a process sync that data
to your bind masters.

Since the bind configuration language is so rich, the approach taken has
been to turn clauses such as zone and view into defined types and make
heavy use of concat fragments.

# Compatibility

This module is built for use with Puppet v3 (with and without the future
parser), v4 and v5 on the following platforms. See `.travis.yml` for an
exact matrix of Puppet releases and ruby versions.

* EL 6

[![Build Status](https://travis-ci.org/ghoneycutt/puppet-module-bind.png?branch=master)](https://travis-ci.org/ghoneycutt/puppet-module-bind)

# Class Descriptions
## Class `bind`

### Description

The bind class manages the software, its configuration and service. All
defined types can be called directly through the bind class by passing
their options as hashes, which is explained for each type. To use,
simply `include ::bind`.

### Parameters

---
#### package (type: String)
Package to be installed for ISC Bind 9.

- *Default*: 'bind-chroot'

---
#### package_ensure (type: String)
Value of ensure attribute for bind package.

- *Default*: 'present'

---
#### config_path (type: String)
Absolute path to named.conf.

- *Default*: '/etc/named.conf'

---
#### config_dir (type: String)
Absolute path to configuration directory.

- *Default*: '/etc/named'

---
#### rndc_key (type: String)
Absolute path to RNDC key.

- *Default*: '/etc/rndc.key'

---
#### rndc_key_secret (type: String)
Secret for rndc_key.

- *Default*: 'U803nlXs4b5x6t7UDw8hnw

---
#### service (type: String)
Name of bind service.

- *Default*: 'named'

---
#### user (type: String)
Bind user.

- *Default*: 'named'

---
#### group (type: String)
Bind group.

- *Default*: 'named'

---
#### named_checkconf (type: String)
Absolute path to named-checkconf.

- *Default*: '/usr/sbin/named-checkconf'

---
#### version (type: String)
Version to be announced. This is queryable, so recommend not using the actual
version.

- *Default*: 'notsoeasy'

---
#### notify_option (type: String)
Value of `notify` option in named.conf.

- *Default*: 'no'

---
#### recursion (type: String)
Value of `recursion` option in named.conf.

- *Default*: 'no'

---
#### forwarders (type: Array)
Value of `forwarders` option in named.conf. If you specify an array with
a single value of 'empty' it will generate an empty forwarders section.

```
forwarders {};
```

- *Default*: undef

---
#### zone_statistics (type: String)
Value of `zone-statistics` option in named.conf.

- *Default*: 'yes'

---
#### allow_query (type: String)
Value of `allow-query` option in named.conf.

- *Default*: 'any'

---
#### allow_transfer (type: String)
Value of `allow-transfer` option in named.conf.

- *Default*: 'none'

---
#### cleaning_interval (type: Integer)
Value of `cleaning-interval` option in named.conf.

- *Default*: 1440

---
#### check_names (type: String)
Value used in `check-names` option in named.conf. The template will add the
type (master or slave) based on the `type` parameter. Valid values are 'fail',
'ignore' and 'warn'.

- *Default*: 'ignore'

---
#### port (type: Integer)
Value used in `listen-on` option in named.conf.

- *Default*: 53

---
#### listen_from (type: String)
Value used in `listen-on` option in named.conf.

- *Default*: 'any'

---
#### dnssec_enable (type: String)
Value of `dnssec-enable` option in named.conf.

- *Default*: 'no'

---
#### dnssec_validation (type: String)
Value of `dnssec-validation` option in named.conf.

- *Default*: 'no'

---
#### directory (type: String)
Value of `directory` option in named.conf.

- *Default*: '/var/named'

---
#### dump_file (type: String)
Value of `dump-file` option in named.conf.

- *Default*: '/var/named/data/cache_dump.db'

---
#### statistics_file (type: String)
Value of `statistics-file` option in named.conf.

- *Default*: '/var/named/data/named_stats.txt'

---
#### memstatistics_file (type: String)
Value of `memstatistics-file` option in named.conf.

- *Default*: '/var/named/data/named_mem_stats.txt'

---
#### type (type: String)
Type of bind system. Valid values are 'master' and 'slave'.

- *Default*: 'master'

---
#### default_logging_channel (type: String)
Name of default logging channel to use. Valid values are 'default_syslog',
'default_debug', 'default_stderr' and 'null'.

- *Default*: 'default_syslog'

---
#### use_default_logging_channel (type: Boolean)
Determines if bind::channel should be called for the `default_logging_channel`.

- *Default*: true

---
#### enable_logging_category_default (type: Boolean)
Determine if the logging category `default` should be enabled.

- *Default*: false

---
#### logging_category_default_channels (type: Array)
List of channels for logging category `default`.