AWS Node Termination Handler

Gracefully handle EC2 instance shutdown within Kubernetes

Community Meeting

NTH community meeting is hosted on a monthly cadence. Everyone is welcome to participate!

• When: first Tuesday of every month from 9:00-9:30AM PST | Calendar Event (ics)
• Where: Chime meeting bridge

Project Summary

This project ensures that the Kubernetes control plane responds appropriately to events that can cause your EC2 instance to become unavailable, such as EC2 maintenance events, EC2 Spot interruptions, ASG Scale-In, ASG AZ Rebalance, and EC2 Instance Termination via the API or Console. If not handled, your application code may not stop gracefully, take longer to recover full availability, or accidentally schedule work to nodes that are going down.

Major Features

• Monitors an SQS Queue for:
  • EC2 Spot Interruption Notifications
  • EC2 Instance Rebalance Recommendation
  • EC2 Auto-Scaling Group Termination Lifecycle Hooks to take care of ASG Scale-In, AZ-Rebalance, Unhealthy Instances, and more!
  • EC2 Status Change Events
  • EC2 Scheduled Change events from AWS Health
• Webhook feature to send shutdown or restart notification messages
• Unit & Integration Tests

Installation and Configuration

TBD

Installation and Configuration

TBD

Infrastructure Setup

TBD

Building

For build instructions please consult BUILD.md.

Metrics

TBD

Communication

• If you've run into a bug or have a new feature request, please open an issue.
• You can also chat with us in the Kubernetes Slack in the #provider-aws channel
• Check out the open source Amazon EC2 Spot Instances Integrations Roadmap to see what we're working on and give us feedback!

Contributing

Contributions are welcome! Please read our guidelines and our Code of Conduct

License

This project is licensed under the Apache-2.0 License.