README
¶
AWS Node Termination Handler
The AWS Node Termination Handler is an operational DaemonSet built to run on any Kubernetes cluster using AWS EC2 Spot Instances. When a user starts the termination handler, the handler watches the AWS instance metadata service for spot instance interruptions within a customer's account. If a termination notice is received for an instance that’s running on the cluster, the termination handler begins a multi-step cordon and drain process for the node.
You can run the termination handler on any Kubernetes cluster running on AWS, including clusters created with Amazon Elastic Kubernetes Service.
Getting Started
The termination handler consists of a ServiceAccount, ClusterRole, ClusterRoleBinding, and a DaemonSet. All four of these Kubernetes constructs are required, and pod access to instance metadata is required for the termination handler to run properly.
To install:
helm repo add eks https://aws.github.io/eks-charts
helm install --name aws-node-termination-handler --namespace kube-system eks/aws-node-termination-handler
For helm3:
helm install aws-node-termination-handler --namespace kube-system eks/aws-node-termination-handler
Helm
The helm chart for this project is located in the eks-charts repo. For instructions on how to install/configure the chart see the project's README.
Building
For build instructions please consult BUILD.md.
Communication
- Found a bug? Please open an issue.
- Have a feature request? Please open an issue.
- Want to contribute? Please submit a pull request.
- Ask a question or chat with us in the Kubernetes Slack
#provider-awschannel
Contributing
Contributions are welcome! Please read our guidelines and our Code of Conduct
License
This project is licensed under the Apache-2.0 License.
Directories