amazon_dns

Provides a set of LWRPs to manage Amazon Route 53 entries.

This works as a drop-in replacement for the official route53 cookbook, but adds a few features.

Platforms

Tested on Ubuntu 12.04 and Debian 6.0.6.

Requirements

Chef 11

Examples

# Create a zone for example.com
amazon_dns_zone "example.com" do
  aws_access_key_id     "ASDASDASDASD"
  aws_secret_access_key "GSDFGSDFDFGF"
end


# Add subdomain1 to example.com
amazon_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
amazon_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

# Create an MX record after specifing credentials via node attribute
node.set[:amazon_dns][:aws_access_key_id] = "ASDASDASDASD"
node.set[:amazon_dns][:aws_secret_access_key] = "GSDFGSDFDFGF"

amazon_dns_record "example.com" do
  domain "example.com"
  type "MX"
  value "1 aspmx.l.google.com"
end

# Instead of replacing the value of a record, we can add to it.
# Here, we create an NS record (if it doesn't exist), or add to the existing value (if it does exist).
amazon_dns_record "nsrecord" do
  domain "example.com"
  addvalue "subdomain1.example.com."
  type "NS"
  aws_access_key_id     "ASDASDASDASD"
  aws_secret_access_key "GSDFGSDFDFGF"
end

# Add another value to our NS record, after this the value will be:
# subdomain1.example.com.
# subdomain2.example.com.
amazon_dns_record "nsrecord" do
  domain "example.com"
  addvalue "subdomain2.example.com."
  type "NS"
  aws_access_key_id     "ASDASDASDASD"
  aws_secret_access_key "GSDFGSDFDFGF"
end

Differences from Route53 cookbook

• Ability to add zones
• No need to specify zone_id, amazon_dns will look it up for you
• Alias record support
• Ability to add to an existing record without overwriting it (addvalue)

Authorization

You can either set the node attributes node[:amazon_dns][:aws_access_key_id] and node[:amazon_dns][:aws_secret_access_key], or provide the same values with every resource call. See examples above.

Alias records

Alias records are A or AAAA records that point to S3 Website Endpoints, Elastic Load Balancers or Route 53 record sets in the same zone. To utilize alias records, set the alias_target attribute of the amazon_dns_record resource to a hash containing the keys :dns_name for the endpoint, and :hosted_zone_id for the hosted zone id.

Recipes

amazon_dns::default

Installs the fog gem, which is needed for the LWRPs.

Attributes

Resources / Providers

amazon_dns_zone

Creates a new Route53 zone.

Attributes

Actions

amazon_dns_record

Attributes

Actions