cookbook 'pdns', '= 1.0.1'
pdns
(50) Versions
1.0.1
-
-
10.0.0
-
9.0.0
-
8.0.3
-
8.0.2
-
8.0.1
-
8.0.0
-
6.1.1
-
6.1.0
-
6.0.0
-
5.0.0
-
4.4.0
-
4.3.1
-
4.3.0
-
4.2.0
-
4.1.0
-
4.0.0
-
3.5.0
-
3.4.1
-
3.4.0
-
3.3.2
-
3.3.1
-
3.3.0
-
3.2.0
-
3.1.0
-
3.0.0
-
2.5.0
-
2.4.1
-
2.4.0
-
2.3.0
-
2.2.1
-
2.2.0
-
2.1.1
-
2.1.0
-
2.0.0
-
1.1.1
-
1.1.0
-
1.0.5
-
1.0.4
-
1.0.3
-
1.0.2
-
1.0.1
-
1.0.0
-
0.3.4
-
0.3.2
-
0.3.0
-
0.2.0
-
0.1.2
-
0.1.0
-
0.0.2
-
0.0.1
Follow14
- 10.0.0
- 9.0.0
- 8.0.3
- 8.0.2
- 8.0.1
- 8.0.0
- 6.1.1
- 6.1.0
- 6.0.0
- 5.0.0
- 4.4.0
- 4.3.1
- 4.3.0
- 4.2.0
- 4.1.0
- 4.0.0
- 3.5.0
- 3.4.1
- 3.4.0
- 3.3.2
- 3.3.1
- 3.3.0
- 3.2.0
- 3.1.0
- 3.0.0
- 2.5.0
- 2.4.1
- 2.4.0
- 2.3.0
- 2.2.1
- 2.2.0
- 2.1.1
- 2.1.0
- 2.0.0
- 1.1.1
- 1.1.0
- 1.0.5
- 1.0.4
- 1.0.3
- 1.0.2
- 1.0.1
- 1.0.0
- 0.3.4
- 0.3.2
- 0.3.0
- 0.2.0
- 0.1.2
- 0.1.0
- 0.0.2
- 0.0.1
Installs/Configures PowerDNS Recursor and Authoritative server
cookbook 'pdns', '= 1.0.1', :supermarket
knife supermarket install pdns
knife supermarket download pdns
pdns Cookbook
Installs and configures PowerDNS (pdns). Sets up a recursor 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 type of PowerDNS server you are installing. This can be either
a PowerDNS recursor, or an authoritative DNS name server. The default attributes apply to both types of installations.
default
Key | Type | Description | Default |
---|---|---|---|
node['pdns']['user'] |
String | User to setuid the pdns daemons | pdns |
node['pdns']['group'] |
String | Group to setuid the pdns daemons | pdns |
node['pdns']['build_method'] |
String | Type of installation, 'package' or 'source' | package |
authoritative
<table>
<tr>
<th>Key</th>
<th>Type</th>
<th>Description</th>
<th>Default</th>
</tr>
<tr>
<td><tt>['pdns']['authoritative']['config_dir']</tt></td>
<td>String</td>
<td>Path to the config directory</td>
<td><tt>/etc/powerdns</tt></td>
</tr>
<tr>
<td><tt>['pdns']['authoritative']['source']['url']</tt></td>
<td>String</td>
<td>URL to the PowerDNS Authoritative DNS Server Source Package</td>
<td><tt>https://downloads.powerdns.com/releases/pdns-3.4.1.tar.bz2</tt></td>
</tr>
<tr>
<td><tt>['pdns']['authoritative']['source']['path']</tt></td>
<td>String</td>
<td>The base path to setting up the source installation</td>
<td><tt>/opt</tt></td>
</tr>
<tr>
<td><tt>['pdns']['authoritative']['source']['backends']</tt></td>
<td>Array</td>
<td>List of backends to build and configure with PowerDNS</td>
<td><tt>['pipe']</tt></td>
</tr>
<tr>
<td><tt>['pdns']['authoritative']['package']['backends']</tt></td>
<td>Array</td>
<td>List of backends to install and configure with PowerDNS via packages</td>
<td><tt>['pipe']</tt></td>
</tr>
</table>
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.
Recipes
authoritative
Sets up a PowerDNS Authoritative Server. Uses the pipe backend by default.
authoritative_source
Sets up a PowerDNS Authoritative Server from source. This is automatically selected
based upon the node['pdns']['build_method']
attribute.
authoritative_package
Sets up a PowerDNS Authoritative Server from packages. This is automatically selected
based upon the node['pdns']['build_method']
attribute. It is also the default install
method.
recursor
Sets up a PowerDNS Recursor from packages.
Usage
To set up a Recursor, simply put recipe[pdns::recursor]
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::authoritative]
in the run list. If another backend besides SQLite is desired, change the node["pdns"]["server"]["backend"]
attribute.
License & Authors
- Author:: Joshua Timberman (joshua@opscode.com)
- 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, Opscode, 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.
Dependent cookbooks
build-essential >= 0.0.0 |
resolvconf >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
1.0.1 / 2014-12-17
Bug Fixes
- Adding missing configuration bits for authoritative_package recipe
1.0.0 / 2014-12-15
Breaking Changes
There have been major changes to the recipes and attributes of this
cookbook in the first of many efforts to stabilize and modernize everything.
Please review the updated README and take special note of the install type
and backend attributes to suit your configuration.We plan to eventually migrate the recipes over to LWRP's to make this
cookbook easier to wrap and extend.
0.3.4 / 2014-07-15
Testing
- Testing Updates
Bug Fixes
- Fixed missing build-essential include
0.3.3 / 2014-07-15
Bug Fixes
- Not actually sure what happened here
0.3.2 / 2014-07-14
Bug Fixes
- Remove incorrect search domains
0.3.0 / 2014-02-21
Bug Fixes
- DNS should install the sqlite gem (needs build-essentials) and use the correct pdns template filename [COOK-978]
0.2.0 / 2013-08-28
Improvements
- Add source recipe [COOK-3106]
0.1.2 / 2013-05-07
Bug Fixes
- pdns cookbook has foodcritic failures [COOK-2986]
Improvements
- Configure a PowerDNS server [COOK-2604]
0.1.0
Initial Release
- Fixes for centos/rhel boxen and pdns::recursor cookbook [COOK-1080]
Foodcritic Metric
1.0.1 failed this metric
FC002: Avoid string interpolation where not required: /tmp/cook/6d71170c7de8b57d6ccb52c4/pdns/recipes/authoritative_source.rb:51
FC031: Cookbook without metadata file: /tmp/cook/6d71170c7de8b57d6ccb52c4/pdns/metadata.rb:1
FC045: Consider setting cookbook name in metadata: /tmp/cook/6d71170c7de8b57d6ccb52c4/pdns/metadata.rb:1
1.0.1 failed this metric
FC031: Cookbook without metadata file: /tmp/cook/6d71170c7de8b57d6ccb52c4/pdns/metadata.rb:1
FC045: Consider setting cookbook name in metadata: /tmp/cook/6d71170c7de8b57d6ccb52c4/pdns/metadata.rb:1