route53-sidecar

Adds a route53 record on Docker startup, removes it on SIGHUP shutdown

Takes the public IP address from ec2 metadata (or IPADDRESS environment)
Creates a weighted A record pointing to DNS with TTL DNSTTL in the HOSTEDZONE
When SIGHUP happens, it removes the created record
Then waits for the record to SYNC in route53 servers
Finally it waits for DNS TTL time to expire
Then exits 0

Environment variables:

IPADDRESS The ip address, or set as public-ipv4 (default) to get it from instance metadata
DNS The fully qualified DNS name to set
DNSTTL The TTL time for the DNS A record entry
HOSTEDZONE The AWS Route53 Hosted Zone ID

Test from command line:

make build
./route53-sidecar -dns="test.example.com" -hostedzone=ABCDEFGHIJKLM4 -ipaddress=127.0.0.1

Use the existing docker image locally:

docker run -v ~/.aws:/root/.aws discobean/route53-sidecar -dns="test.example.com" -hostedzone=ABCDEFGHIJKLM4 -ipaddress=127.0.0.1

Build your own docker image:

make docker

Policies required for AWS ECS Role:

- PolicyName: route53
  PolicyDocument:
    Statement:
    - Effect: Allow
      Action:
        - route53:ChangeResourceRecordSets
      Resource: !Sub arn:aws:route53:::hostedzone/${HOSTEDZONEID}
- PolicyName: route53changes
  PolicyDocument:
    Statement:
    - Effect: Allow
      Action:
        - route53:GetChange
      Resource: "*"

beezly/route53-sidecar

route53-sidecar