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:

Recipes

generic_dns::default

Installs prequisites for either the amazon_dns or dnsimple cookbook.

Attributes

default

Resources / Providers

generic_dns_record

Creates a record using either DNSimple or Amazon Route 53.

If using Amazon, creates a zone as needed.

Attributes

Actions

generic_dns_template

Creates DNS records from predefined templates

Attributes

Actions

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

Actions