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

The route53 cookbook has been deprecated

Author provided reason for deprecation:

The route53 cookbook has been deprecated and is no longer being maintained by its authors. Use of the route53 cookbook is no longer recommended.

You may find that the aws cookbook is a suitable alternative.


route53 (21) Versions 2.0.0

Providces resources for managing Amazon Route53 DNS

cookbook 'route53', '~> 2.0.0', :supermarket
cookbook 'route53', '~> 2.0.0'
knife supermarket install route53
knife supermarket download route53
Quality 17%

route53 cookbook

Build Status Cookbook Version

Updates Amazon Web Service's Route 53 (DNS) service.

Amazon Route 53 can be used as DNS for any registered domain name. This cookbook provides a single resource route53_record that allows you to create or delete records.



  • all platforms where the aws-sdk works


  • Chef 12.9+


  • none


route53_record "create a record" do
  name  "test"
  value ""
  type  "A"

  # The following are for routing policies
  weight "1" (optional)
  set_identifier "my-instance-id" (optional-must be unique)
  zone_id               node[:route53][:zone_id]
  aws_access_key_id     node[:route53][:aws_access_key_id]
  aws_secret_access_key node[:route53][:aws_secret_access_key]
  overwrite true
  fail_on_error false (set to true to report failure to Chef)
  action :create

NOTE: If you do not specify aws credentials, it will attempt to use the AWS IAM Role assigned to the instance instead.

kitchen converge

Resources Overview



  • name Required. String. - name of the domain or subdomain.
  • value String Array - value appropriate to the type.. for type 'A' value would be an IP address in IPv4 format for example.
  • type Required. String DNS record type
  • ttl Integer default: 3600 - time to live, the amount of time in seconds to cache information about the record
  • weight Optional. String. - a value that determines the proportion of DNS queries that will use this record for the response. Valid options are between 0-255. NOT CURRENTLY IMPLEMENTED
  • set_identifier Optional . String. - a value that uniquely identifies record in the group of weighted record sets
  • geo_location String.
  • geo_location_country String
  • geo_location_continent String
  • geo_location_subdivision String
  • set_identifier String
  • zone_id String
  • aws_access_key_id String
  • aws_secret_access_key String
  • aws_region String default: 'us-east-1'
  • overwrite [true false] default: true
  • alias_target Optional. Hash. - Associated with Amazon 'alias' type records. The hash contents varies depending on the type of target the alias points to.
  • mock [true false] default: false
  • fail_on_error [true false] default: false

ChefSpec Matcher

This Cookbook includes a Custom Matcher for testing the route53_record LWRP with ChefSpec.

To utilize this Custom Matcher use the following test your spec:

expect(chef_run).to create_route53_record('')

Development Notes

A useful reference for the structure of the AWS route53 requests:

And the relevant AWS-SDK doc:

License & Authors

Copyright:: 2011-2016, Heavy Water Software
Copyright:: 2016-2017, Chef Software

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

strongSwan-base Applicable Versions
strongswan Applicable Versions

route53 Cookbook CHANGELOG

This file is used to list changes made in each version of the route53 cookbook.

2.0.0 (2017-06-06)

  • Convert to a custom resource and use gem install in metadata to install the aws-sdk. This cookbook now requires Chef 12.9 or later
  • Fix resource to properly converge and support why-run mode

1.2.2 (2017-06-06)

  • Test with Local Delivery instead of Rake
  • Documentation update, removal of duplicate attributes
  • Update Apache license string in metadata
  • Simplify true/false in the readme
  • respond_to?(:) for < 12.6 compat

1.2.1 (2017-01-24)

  • Remove apt from the berksfile as it’s not actually used
  • Fix typo that caused a failure in the resource
  • Add a better description of this cookbook in the metadata
  • Add basic platforms to the metadata to aid in Supermarket searches
  • Expand the testing doc to explain the AWS-isms

1.2.0 (2017-01-21)

  • Adds fail_on_error option to the resource

1.1.1 (2016-12-19)

  • Fix the authentication when an IAM role is attached to an EC2 instance

1.1.0 (2016-09-21)

  • Fix current_resource_record_set and add alias_target data
  • Remove chef 11 compat in chef_gem resource

1.0.0 (2016-09-16)

  • Require Chef 12.1+
  • Add ability to set weight and set_identifier so you can use a weighted
  • Refactor to use the AWS gem instead of fog
  • LWRP now auto installs the gem if it's not present. No need for the default recipe
  • Add use_inline_resources to the provider
  • Fixed wrong number of arguments bug.
  • Remove librarian cheffile
  • Add license file
  • Add testing, contributing, and maintainers docs
  • Change from Heavywater Software to Chef Software
  • Add chef_version metadata
  • Update Test Kitchen config
  • Add standard testing Rakefile


  • update for continued Chef 11 support
  • .gitignore update


  • fog version 1.37.0
  • chef_gem compile_time false
  • geo_location support


  • make "name" the name_attribute of a resource
  • depends on xml to support installing nokogiri and fog dependency


  • allow for nokogiri version to be specified


  • proper support for serverspec tests
  • make sure needed resource defaults are required
  • fog require error


  • enhancements to supported TDD tools
  • New Delete action available for record resource
  • add aws secret token auth attribute support
  • support mock record
  • handle trailing dot on record names
  • move nokogiri requires so they do not happen before chef_gem


  • change to attribute names in the build-essential dependency cookbook


  • support for alias records
  • build-essential to correct fog build errors
  • install specific fog version by setting attribute
  • test-kitchen support and begin enhanced testing frameworks


  • Add missing "name" attribute to metadata
  • install correct libxml2 and libxslt package names for rhel family
  • allow multiple MX records (or records in general), passed as array
  • Added IAM role support
  • Use chef_gem resource for fog install
  • correct working record creation and overwrite logic

Collaborator Number Metric

2.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

2.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, and your repo must contain a file

Foodcritic Metric

2.0.0 failed this metric

FC108: Resource should not define a property named 'name': route53/resources/record.rb:1
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

2.0.0 passed this metric

Testing File Metric

2.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, and your repo must contain a file

Version Tag Metric

2.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, and your repo must include a tag that matches this cookbook version number