Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status

RSS

generic_dns (1) Versions 1.0.1

Generic DNS LWRPs and DNS templates

Policyfile
Berkshelf
Knife
cookbook 'generic_dns', '~> 1.0.1', :supermarket
cookbook 'generic_dns', '~> 1.0.1'
knife supermarket install generic_dns
knife supermarket download generic_dns
README
Dependencies
Quality 17%

generic_dns

Provides a set of LWRPs to manage DNS records, using Amazon Route 53 or DNSimple.

Also provides DNS templates for commonly used services, such as Google Mail.

Platforms

Tested on Ubuntu 12.04 and Debian 6.0.6.

Requirements

Chef 11

Examples

node.set[:generic_dns][:default_dns_provider] = :amazon

# Add subdomain1 to example.com using Route 53
generic_dns_record "subdomain1" do
  value "192.168.1.1"
  domain "example.com"
  aws_access_key_id     "ASDASDASDASD"
  aws_secret_access_key "GSDFGSDFDFGF"
end

# Let's add a CNAME record using DNSimple
generic_dns_record "mail" do
  value "ghs.google.com"
  domain "example.com"
  type "CNAME"
  ttl 86400
  aws_access_key_id     "ASDASDASDASD"
  aws_secret_access_key "GSDFGSDFDFGF"
end

# Apply the google mail template to add MX records and a TXT spf record
generic_dns_template "google_mail" do
  domain "example.com"
  aws_access_key_id     "ASDASDASDASD"
  aws_secret_access_key "GSDFGSDFDFGF"
end

Authentication

You can either provide authentication via resource attributes (see generic_dns_record attributes), or as node attributes.

For node attributes, use node[:dnsimple][:username] and node[:dnsimple][:password] or node[:amazon_dns][:aws_access_key_id] and node[:amazon_dns][:aws_secret_access_key].

Templates

Templates are simply a number of predefined DNS records.

For example, the google_mail template will add an MX record with the 5 gmail servers and their priorities, as well as a TXT record used in SPF.

The following templates are available:

Template Description
google_mail Set up Google Mail

Recipes

generic_dns::default

Installs prequisites for either the amazon_dns or dnsimple cookbook.

Attributes

default

Attribute Description Type Default
default_dns_provider The dns provider you want to use, amazon or dnsimple String, Symbol :amazon

Resources / Providers

generic_dns_record

Creates a record using either DNSimple or Amazon Route 53.

If using Amazon, creates a zone as needed.

Attributes

Attribute Description Type Default
dns_provider Which DNS provider to use, overrides node attribute String, Symbol
name Name of the dns entry, can be "subdomain" or "subdomain.example.com" String name
domain Name of the domain to add the entry to (set this or zone_id) String
value Value for the DNS record. Not needed for Amazon alias records String, Array
type DNS record type String A
ttl Time to live Integer, String 3600
weight For weighted record sets. Amazon only Integer, String
zone_id Zone_id of the zone to add the entry to (set this or domain). Amazon only String
alias_target Targets for alias records. Hash that needs they keys :dns_name and :hosted_zone_id. Amazon only Hash
aws_access_key_id Your AWS access key ID. Amazon only String
aws_secret_access_key Your AWS secret access key. Amazon only String
dnsimple_username Username for your DNSimple account. DNSimple only String
dnsimple_password Password for your DNSimple account. DNSimple only String

Actions

Name Description Default
create_or_update Create or update the record yes

generic_dns_template

Creates DNS records from predefined templates

Attributes

Attribute Description Type Default
dns_provider Which DNS provider to use, overrides node attribute String, Symbol
template_name Name of the template to apply String name
domain Name of the domain to add the entry to String
aws_access_key_id Your AWS access key ID. Amazon only String
aws_secret_access_key Your AWS secret access key. Amazon only String
dnsimple_username Username for your DNSimple account. DNSimple only String
dnsimple_password Password for your DNSimple account. DNSimple only String

Actions

Name Description Default
create_or_update Create or update the record yes

generic_dns_from_databag

Sets up DNS records and templates from a data bag.

The data bag items need the following structure:

{
  "id": "example_com",
  "domain_name": "example.com",
  "templates": [
    "google_mail"
  ],
  "records": [
    { "name": "promisedlandt.de",
      "content": "192.168.1.1" },
    { "name": "subdomain1",
      "type": "AAAA",
      "ttl": 3600,
      "content": "2001:0db8:0000:0000:0000:ff00:0042:8329" }
  ]
}

You can authenticate either by passing the usual attributes, or from an encrypted data bag.

If you decide to go the data bag route, for AWS, you need the keys "aws_access_key_id" and "aws_secret_access_key".

For DNSimple, you need "login" and "password".

Attributes

Attribute Description Type Default
dns_provider Which DNS provider to use, overrides node attribute String, Symbol
dns_data_bag_name Name of the data bag you store your DNS info in String name
credentials_data_bag_name Name of the data bag your credentials are stored it (if you don't specify them directly) String
credentials_data_bag_item Item in your credentials data bag String
aws_access_key_id Your AWS access key ID. Amazon only String
aws_secret_access_key Your AWS secret access key. Amazon only String
dnsimple_username Username for your DNSimple account. DNSimple only String
dnsimple_password Password for your DNSimple account. DNSimple only String

Actions

Name Description Default
create_or_update Create or update the records / templates yes

Dependent cookbooks

amazon_dns >= 0.0.0
dnsimple >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Collaborator Number Metric
            

1.0.1 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.1 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.1 failed this metric

FC064: Ensure issues_url is set in metadata: generic_dns/metadata.rb:1
FC065: Ensure source_url is set in metadata: generic_dns/metadata.rb:1
FC066: Ensure chef_version is set in metadata: generic_dns/metadata.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric
            

1.0.1 passed this metric

Testing File Metric
            

1.0.1 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.1 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