Service Catalog Version 0.78.1

Route 53 Hosted Zones

View SourceFiltered Release Notes

Overview

This service contains code to deploy Route 53 Hosted Zones and AWS Cloud Map Namespaces on AWS.

Route 53 architecture

Features

• Manage DNS entries using AWS Route 53 or AWS Cloud Map
• Optionally order and automatically verify ACM wildcard certificates for public zones
• Automatic health checks to route traffic only to healthy endpoints
• Automatic integration with other AWS services, such as ELBs

Learn

note

This repo is a part of the Gruntwork Service Catalog, a collection of reusable, battle-tested, production ready infrastructure code. If you’ve never used the Service Catalog before, make sure to read How to use the Gruntwork Service Catalog!

• Should you use AWS Route 53 or CloudMap for your DNS entries?
• AWS Cloud Map Documentation: Amazon’s docs for AWS Cloud Map that cover core concepts and configuration.
• Route 53 Documentation: Amazon’s docs for Route 53 that cover core concepts and configuration.

Deploy

Non-production deployment (quick start for learning)

If you just want to try this repo out for experimenting and learning, check out the following resources:

• examples/for-learning-and-testing folder: The examples/for-learning-and-testing folder contains standalone sample code optimized for learning, experimenting, and testing (but not direct production usage).

Production deployment

If you want to deploy this repo in production, check out the following resources:

• examples/for-production folder: The examples/for-production folder contains sample code optimized for direct usage in production. This is code from the Gruntwork Reference Architecture, and it shows you how we build an end-to-end, integrated tech stack on top of the Gruntwork Service Catalog.

Reference

Inputs

• private_zones — A map of private Route 53 Hosted Zones. In this map, the key should be the domain name. See examples below.

• public_zones — A map of public Route 53 Hosted Zones. In this map, the key should be the domain name. See examples below.

• service_discovery_private_namespaces — A map of domain names to configurations for setting up a new private namespace in AWS Cloud Map.

• service_discovery_public_namespaces — A map of domain names to configurations for setting up a new public namespace in AWS Cloud Map. Note that the domain name must be registered with Route 53.

Outputs

• acm_tls_certificates — A list of ARNs of the wildcard and service discovery certificates that were provisioned along with the Route 53 zone.

• private_domain_names — The names of the internal-only Route 53 Hosted Zones

• private_zones_ids — The IDs of the internal-only Route 53 Hosted Zones

• private_zones_name_servers — The name servers associated with the internal-only Route 53 Hosted Zones

• public_domain_names — The names of the public Route 53 Hosted Zones

• public_hosted_zone_map — A map of domains to their zone IDs. IDs are user inputs, when supplied, and otherwise resource IDs

• public_hosted_zones_ids — The IDs of the public Route 53 Hosted Zones

• public_hosted_zones_name_servers — The name servers associated with the public Route 53 Hosted Zones

• service_discovery_private_namespaces — A map of domains to resource arns and hosted zones of the created Service Discovery Private Namespaces.

• service_discovery_public_namespaces — A map of domains to resource arns and hosted zones of the created Service Discovery Public Namespaces.