Skip to main content
Module Server 0.16.1Last updated in version 0.13.4

Route 53 Helpers

View Source Release Notes

This folder contains helper scripts for working with Amazon's DNS Service, Route 53. The helpers are:

  • add-dns-a-record: A script that can be run on an EC2 instance to add a DNS A record pointing to the instance's IP address.

Check out the route53-helpers example for how to use these scripts with Terraform.

Installing the helpers​

You can install the helpers using the Gruntwork Installer:

gruntwork-install --module-name "route53-helpers" --repo "https://github.com/gruntwork-io/terraform-aws-server" --tag "0.0.3"

Using the add-dns-a-record helper​

The add-dns-a-record script has the following prerequisites:

  1. It must be run on an EC2 instance
  2. The EC2 instance must have an IAM role with permissions to modify Route 53 entries (see below)
  3. The EC2 instance must have the AWS CLI and jq installed

To run the script, simply pass it the AWS region, the id of the hosted zone where the DNS entry should be added, and the hostname to use for the DNS entry:

add-dns-a-record --aws-region us-east-1 --hosted-zone-id ASDF123456 --hostname foo.my-company.com

Run add-dns-a-record --help to see all available options.

IAM Permissions​

Here is an example of an IAM policy your EC2 instance needs attached to its IAM role to run these scripts:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Action": "route53:ChangeResourceRecordSets",
      "Effect": "Allow",
      "Resource": "arn:aws:route53:::hostedzone/<ID_OF_HOSTED_ZONE>"
    }
  ]
}

Check out the route53-helpers example to see what this looks like in action.