AWS can interrupt Spot instances, leaving Kubernetes workloads on a machine that is about to disappear. This historical handler watched for notices in instance metadata and attempted to drain the affected node so workloads could move elsewhere. It was useful for improving the chance of an orderly transition. Notice delivery and available lead time are not guaranteed, and a managed node service or another provisioner may already own interruption handling.
Current guidance
The archived stable/k8s-spot-termination-handler chart identifies kube-aws/kube-spot-termination-notice-handler. Its README describes a DaemonSet polling EC2 metadata and lists image tags tied to old kubectl versions. Chart deprecation is confirmed, but this review does not assert a project-wide retirement notice or a supported current image.
AWS documents Spot interruption notices as best effort; hibernation does not provide the usual two-minute lead time. Design applications to tolerate node loss rather than treating graceful drain as guaranteed. Check metadata access, pod termination grace periods, disruption budgets and whether enough replacement capacity can become ready.
The separate AWS Node Termination Handler supports metadata-monitor and queue-processor modes with different permissions and event coverage. Its README also says EKS managed node groups do not require that handler. Determine what your node group or provisioning system already handles before installing another drainer. Test a controlled interruption, confirm workloads resume elsewhere and inspect stalled evictions. Do not copy old cluster-admin and image defaults into a modern cluster solely because the chart still renders.
Historical upstream link check · 2026-10-09
The recorded upstream address responded successfully (HTTP 200) on 2026-10-09. GitHub confirms that helm/charts is archived: this is a historical chart distribution, not evidence that the application itself is retired. Link availability does not certify the historical installation instructions or current security support.
Website availability is separate from project, chart and image support. Use the current guidance and primary sources on this page to assess the distribution.
Historical Kubedex content
Original publication: 2018-12-22T08:41:28+00:00. Preserved for context. Commands, versions, prices and results below reflect the original research.
The K8s Spot Termination handler watches the AWS metadata service when running on Spot Instances.
When a Spot Instance is due to be terminated, precisely 2 minutes before it’s termination a “termination notice” is issued. The K8s Spot Termination Handler watches for this and then gracefully drains the node it is running on before the node is taken away by AWS.
The post k8s spot termination handler appeared first on kubedex.com.
Sources & further reading
Spotted something that needs another look?
Help improve this page →