pdns Cookbook

Installs and configures PowerDNS (pdns). Sets up an authoritative by default and can set up an Authoritative Server with multiple backends.

Requirements

Platforms:

• Ubuntu (12.04, 14.04)

Required Cookbooks:

• build-essential (for source build)
• resolvconf (used in the server recipe for setting resolv.conf)

Suggested Cookbooks:

• mysql (for the MySQL backend)
• sqlite (for the SQLite backend)
• postgres (for the PostgreSQL backend)

Attributes

Depending on the type of server you are installing there are specific options you may want to set via attributes. Each
attribute file (other than default) corresponds to the combination of PowerDNS server you are installing (flavor) and
install method. This can be either a PowerDNS recursor, an authoritative DNS name server, or a slave DNS server. All of them
can be build from source or installed from packages except the recursor that currently is only available from packages.

The different combinations of install method and functionality are controlled by the default attributes 'build_method' and 'flavor'

default

source

package

authoritative

slave

recursor

authoritative server configuration

The ['pdns']['authoritative']['config'] array directly maps to each
configuration directive in the configuration file. Of special note is
any configuration option that needs a hyphen (-) should be defined
as an underscore (_) and it will be converted at compilation time.

For example, if you want the version-string setting to be changed, you'll want
to define it like so:

default['pdns']['authoritative']['config']['version_string'] = 'awesomedns'

Another thing to note is boolean values are mapped to 'yes' and 'no'
respectively. If you want to remove a value, simply set it to 'nil' or do not
define the attribute entirely.

recursor

The ['pdns']['recursor']['config'] array directly maps to each
configuration directive in the configuration file. Of special note is
any configuration option that needs a hyphen (-) should be defined
as an underscore (_) and it will be converted at compilation time.

For example, if you want the version-string setting to be changed, you'll want
to define it like so:

default['pdns']['recursor']['config']['local_port'] = '53'

Another thing to note is boolean values are mapped to 'yes' and 'no'
respectively. If you want to remove a value, simply set it to 'nil' or do not
define the attribute entirely.

slave

The ['pdns']['slave']['config'] array directly maps to each
configuration directive in the configuration file. Of special note is
any configuration option that needs a hyphen (-) should be defined
as an underscore (_) and it will be converted at compilation time.

For example, if you want the version-string setting to be changed, you'll want
to define it like so:

default['pdns']['slave']['config']['local_port'] = '53'

Another thing to note is boolean values are mapped to 'yes' and 'no'
respectively. If you want to remove a value, simply set it to 'nil' or do not
define the attribute entirely.

Usage

Add the default recipe and set the right attributes ('flavor' and 'install_method') to install and configure PowerDNS as your needs. The default behavior is installing a recursor.

To set up a Recursor, simply put recipe[pdns::default] in the run list. Modify the attributes via a role or on the node directly as required for the local configuration. If using the recursor with an Authoritative Server running on the same system, the local address and port should be changed to a public IP and the forward zones recurse setting to point at the loopback for the local zone. This is generally assumed, and the default listen interface for the recursor is set to the nodes ipaddress attribute.

To set up an authoritative server, put recipe[pdns::default] in the run list and set the attribute node['pdns']['flavor'] to 'authoritative'. If another backend besides SQLite is desired, change the node['pdns']['server']['backend'] attribute. Choose between 'package', 'source' with the node['pdns']['install_method'] attribute. Tune your server specific configuration with node['pdns']['authoritative']['config'].

To set up an slave server, add recipe[pdns::default] to you run list and set the attribute node['pdns']['flavor'] to 'slave'. Choose between 'package', 'source' with the node['pdns']['install_method'] attribute. Tune your server specific configuration with node['pdns']['slave']['config'].

License & Authors

• Author:: Joshua Timberman (joshua@chef.io)
• Author:: Aaron Kalin (aaron.kalin@dnsimple.com)
• Author:: Jacobo García (jacobo.garcia@dnsimple.com)
• Author:: Anthony Eden (anthony.eden@dnsimple.com)

Copyright:: 2010-2014, Chef Software, Inc & 2014 Aetrion, LLC.

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.