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

The route53 cookbook has been deprecated

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.

RSS

route53 (21) Versions 2.0.0

Providces resources for managing Amazon Route53 DNS

Berkshelf/Librarian
Policyfile
Knife
cookbook 'route53', '~> 2.0.0'
cookbook 'route53', '~> 2.0.0', :supermarket
knife cookbook site install route53
knife cookbook site download route53
README
Dependencies
Changelog
Quality

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.

Requirements

Platforms

  • all platforms where the aws-sdk works

Chef

  • Chef 12.9+

Cookbooks

  • none

Usage

route53_record "create a record" do
  name  "test"
  value "16.8.4.2"
  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
end

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

route53_record

Parameters

  • 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('example.com')

Development Notes

A useful reference for the structure of the AWS route53 requests: http://docs.aws.amazon.com/Route53/latest/APIReference/API_ChangeResourceRecordSets_Requests.html#API_ChangeResourceRecordSets_RequestBasicSyntax

And the relevant AWS-SDK doc: http://docs.aws.amazon.com/sdkforruby/api/Aws/Route53/Client.html#change_resource_record_sets-instance_method

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

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
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

v0.4.4

  • update for continued Chef 11 support
  • .gitignore update

v0.4.2

  • fog version 1.37.0
  • chef_gem compile_time false
  • geo_location support

v0.4.0

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

v0.3.8

  • allow for nokogiri version to be specified

v0.3.6

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

v0.3.5

  • 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

v0.3.4

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

v0.3.3

  • 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

v0.3.2

  • 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 passed this metric

Contributing File Metric
            

2.0.0 passed this metric

Foodcritic Metric
            

2.0.0 passed this metric

License Metric
            

2.0.0 passed this metric

No Binaries Metric
            

2.0.0 passed this metric

Publish Metric
            

2.0.0 passed this metric

Supported Platforms Metric
            

2.0.0 passed this metric

Testing File Metric
            

2.0.0 passed this metric

Version Tag Metric
            

2.0.0 passed this metric