ec2-spot-interrupter is a simple CLI tool that triggers Amazon EC2 Spot Interruption Notifications and Rebalance Recommendations.
brew tap aws/tap
brew install ec2-spot-interrupter
Amazon EC2 Spot Instances let you run flexible, fault-tolerant, or stateless applications in the AWS Cloud at up to a 90% discount from On-Demand prices. Spot instances are regular EC2 capacity that can be reclaimed by AWS with a 2-minute notification called the Interruption Notification. Applications that are able to gracefully handle this notification and respond by check pointing or draining work can leverage Spot for deeply discounted compute resources! In addition to Interruption Notifications, Rebalance Recommendation Events are sent to spot instances that are at higher risk of being interrupted. Handling Rebalance Recommendations can potentially give your application even more time to gracefully shutdown than the 2 minutes an Interruption Notification would give you.
It can be challenging to test your application's handling of Spot Interruption Notifications and Rebalance Recommendations. The AWS Fault Injection Simulator (FIS) supports sending real Spot Interruptions and Rebalance Recommendations to your spot instances so that you can test how your application responds. However, since FIS is a general purpose fault injection simulation service, it can be cumbersome to setup the required fault injection experiment templates to execute experiments for Spot. The
ec2-spot-interrupter CLI tool streamlines this process as it wraps FIS and allows you to simply pass a list of instance IDs which
ec2-spot-interrupter will use to craft the required experiment templates and then execute those experiments.
For details on how to use the AWS Fault Injection Simulator directly to trigger Spot Interruption Notifications, checkout this blog post.
If you are looking for a tool to test Spot Interruption Notifications and Rebalance Recommendations locally on your laptop (not EC2), then checkout the EC2 Metadata Mock.
$ ec2-spot-interrupter is a simple CLI tool that triggers Amazon EC2 Spot Instance Interruption Notifications and Rebalance Recommendations.
-c, --clean clean up the underlying simulations (default true)
-d, --delay duration duration until the interruption notification is sent (default 15s)
-h, --help help for ec2-spot-interrupter
-i, --instance-ids strings instance IDs to interrupt
--interactive interactive TUI
-p, --profile string the AWS Profile
-r, --region string the AWS Region
-v, --version the version
Try the interactive TUI mode:
$ ec2-spot-interrupter --interactive
Or use the regular CLI options:
$ ec2-spot-interrupter --instance-ids i-0208a716009d70b36
📖 Experiment Summary:
Role ARN: arn:aws:iam::1234567890:role/aws-fis-itn
2022-05-18T11:39:45: ✅ Rebalance Recommendation sent
2022-05-18T11:39:45: ⏳ Interruption will be sent in 15 seconds
2022-05-18T11:40:05: ✅ Spot 2-minute Interruption Notification sent
2022-05-18T11:42:05: ✅ Spot Instance Shutdown sent
If you've run into a bug or have a new feature request, please open an issue.
Check out the open source Amazon EC2 Spot Instances Integrations Roadmap to see what we're working on and give us feedback!
This project is licensed under the Apache-2.0 License.