Simple demo application illustrating running a failover test against an RDS database.

• LocalStack
• Docker
• Python
• make
• awslocal

To install the dependencies:

make install

Make sure that LocalStack is started:

LOCALSTACK_AUTH_TOKEN=... DEBUG=1 localstack start

Run the scenario Python script main.py as follows:

make run

You should see some logs from the script, similar to the output below:

Creating global cluster 'global-cluster-1'
Creating primary DB cluster 'rds-cluster-1'
Creating secondary DB cluster 'rds-cluster-2'
Running assertions, to ensure the cluster writer has been updated
Start global DB cluster failover ...
✅ Test done - all assertions succeeded

This code is available under the Apache 2.0 license.