cookbook 'bind9-easy', '~> 1.0.0'
bind9-easy (5) Versions 1.0.0 Follow2
Installs and autoconfigures bind9 nameserver
cookbook 'bind9-easy', '~> 1.0.0', :supermarket
knife supermarket install bind9-easy
knife supermarket download bind9-easy
https://github.com/computerlyrik/chef-bind9-easy
Description
Autoconfigures bind9 Server the easy way.
Never update your ID again!
Implements a Zone LWRP searching chef and using user input to find all clients.
Supports
- Forwarders
- Transfer servers
- Custom zone entries
- Reverse zones
- MX
- SPF
- XMPP-Entries
Requirements
I am running on an debian/ubuntu server - please report other platforms!
Attributes
List of forwarders where requests should be forwarded to.
```ruby
default['bind9-easy']['forward'] = []
List of servers where zone updates should be transferred to.
```ruby
default['bind9-easy']['transfer'] = []
List of trusted servers allowed to query
ruby
default['bind9-easy']['trusted_server'] = []
Usage
Easy Setup
Just include
ruby
bind9-easy::easy
in your run list.
This autoconfigures a basic setup for your current domain.
For more information see attributes/easy.rb
and recipes/easy.rb
Also try kitchen
to see an example.
Most complex setup:
include_recipe 'bind9-easy' nameservers = ["ns.example.com", "ns1.first-ns.de", "robotns2.second-ns.de", "robotns3.second-ns.com" ] # Configures a automatic zone - all chef clients in this domain will be added magically bind9_easy_zone "example.com" do email "hostmaster.example.com" nameserver nameservers hosts ({ "@" => "192.168.2.1", #Generate an A Record "not-a-chef-client" => "192.168.178.250", #results in a A record "my-hot-box" => "not-a-chef-client" #results in a CNAME record }) mailserver ({ "@" => "mail.example.com", "lists.example.com" => "lists.example.com"}) # another mailserver for subdomain spf true xmpp "xmpp.example.com" #Assuming xmpp is provided by automagic configuration subzones ({ "lan.ns.example.com" => "ns.example.com", "v6.ns.example.com" => "ns.example.com",}) end # generate a Subdomain-Zone for v6 Network bind9_easy_zone "v6.example.com" do email "hostmaster.example.com" nameserver nameservers end # generate a Subdomain-Zone for internal nat bind9_easy_zone "lan.example.com" do email "hostmaster.example.com" nameserver nameservers hosts ({ "@" => "172.2.2.1", }) end
See resources/zone.rb for more zone-file attributes for bind9_easy_zone
Ideas/TODO
- Add NS slave recipe
- Add ipv6
Contact
see metadata.rb
Dependent cookbooks
This cookbook has no specified dependencies.
Contingent cookbooks
There are no cookbooks that are contingent upon this one.
Collaborator Number Metric
1.0.0 failed this metric
Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.
Contributing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.0.0 failed this metric
FC064: Ensure issues_url is set in metadata: bind9-easy/metadata.rb:1
FC065: Ensure source_url is set in metadata: bind9-easy/metadata.rb:1
FC066: Ensure chef_version is set in metadata: bind9-easy/metadata.rb:1
FC069: Ensure standardized license defined in metadata: bind9-easy/metadata.rb:1
FC085: Resource using new_resource.updated_by_last_action to converge resource: bind9-easy/providers/zone.rb:140
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a CONTRIBUTING.md file
Foodcritic Metric
1.0.0 failed this metric
FC064: Ensure issues_url is set in metadata: bind9-easy/metadata.rb:1
FC065: Ensure source_url is set in metadata: bind9-easy/metadata.rb:1
FC066: Ensure chef_version is set in metadata: bind9-easy/metadata.rb:1
FC069: Ensure standardized license defined in metadata: bind9-easy/metadata.rb:1
FC085: Resource using new_resource.updated_by_last_action to converge resource: bind9-easy/providers/zone.rb:140
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
No Binaries Metric
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
FC065: Ensure source_url is set in metadata: bind9-easy/metadata.rb:1
FC066: Ensure chef_version is set in metadata: bind9-easy/metadata.rb:1
FC069: Ensure standardized license defined in metadata: bind9-easy/metadata.rb:1
FC085: Resource using new_resource.updated_by_last_action to converge resource: bind9-easy/providers/zone.rb:140
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any
1.0.0 passed this metric
Testing File Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must contain a TESTING.md file
Version Tag Metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number
1.0.0 failed this metric
1.0.0 failed this metric
Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of https://github.com/user/repo, and your repo must include a tag that matches this cookbook version number