route53-dns-failover

Route53 DNS Failover

Key	Value
Services	Route53, EC2
Integrations	Docker Compose, AWS CLI
Categories	Networking; DNS

Introduction

A demo application illustrating Route53 DNS failover based on health checks using LocalStack. The sample configures Route53 health checks and DNS records with failover routing policies, then demonstrates automatic DNS failover when the primary endpoint becomes unhealthy.

Prerequisites

• A valid LocalStack for AWS license. Your license provides a LOCALSTACK_AUTH_TOKEN to activate LocalStack.
• Docker and Docker Compose
• awslocal CLI

Check prerequisites

make check

Installation

make install

Start LocalStack

export LOCALSTACK_AUTH_TOKEN=<your-auth-token>
make start

This starts LocalStack and supporting services via Docker Compose.

Run the application

make run

The script configures Route53 health checks and DNS failover routing, then demonstrates failover behavior.

License

This code is available under the Apache 2.0 license.