kubeaws/kube-spot-termination-notice-handler

kube-spot-termination-notice-handler 镜像说明

镜像概述

该镜像实现了一个Kubernetes DaemonSet，每个节点运行一个容器，定期轮询EC2 Spot实例终止通知端点。当检测到终止通知时，会在EC2实例终止前最多2分钟内优雅停止该节点上的所有Pod，确保工作负载可迁移到其他实例（如按需实例）。

核心功能

• 定期轮询EC2 Spot实例终止通知端点
• 收到终止通知后优雅停止节点上的Pod
• 支持Slack和Sematext Cloud事件通知
• 自动将实例从AutoScaling Group分离（可选）

使用场景

适用于使用EC2 Spot实例的Kubernetes集群，确保Spot实例被终止时工作负载平滑迁移，减少服务中断风险。

配置说明

安装（Helm）

该工具提供Helm Chart，可通过以下命令安装：

bash
helm install stable/k8s-spot-termination-handler

镜像标签选择

标签对应Kubernetes/kubectl版本，建议使用与集群版本一致的标签：

• kubeaws/kube-spot-termination-notice-handler:1.8.5-1
• kubeaws/kube-spot-termination-notice-handler:1.9.0-1
• kubeaws/kube-spot-termination-notice-handler:1.10.11-2
• kubeaws/kube-spot-termination-notice-handler:1.11.3-1
• kubeaws/kube-spot-termination-notice-handler:1.12.0-2
• kubeaws/kube-spot-termination-notice-handler:1.13.7-1

工作原理

每个Pod轮询终止通知端点，当返回HTTP 200时表示实例将被终止，执行kubectl drain停止Pod。可通过日志查看运行状态：

bash
kubectl logs --namespace kube-system spot-termination-notice-handler-ibyo6

通知配置

Slack通知

设置SLACK_URL环境变量（Slack incoming webhook URL）和CLUSTER变量：

yaml
env:
  - name: SLACK_URL
    value: "https://hooks.slack.com/services/T67UBFNHQ/B4Q7WQM52/1ctEoFjkjdjwsa22934"
  - name: CLUSTER
    value: "development"

Sematext Cloud通知

设置SEMATEXT_URL（根据区域选择）和CLUSTER变量：

yaml
env:
  - name: SEMATEXT_URL
    value: "https://event-receiver.sematext.com/APPLICATION_TOKEN/event"
  - name: CLUSTER
    value: "development"

AutoScaling分离

设置DETACH_ASG为非false值，自动将实例从AutoScaling Group分离：

yaml
env:
  - name: DETACH_ASG
    value: "true"

构建指定K8s版本

通过KUBE_VERSION变量指定Kubernetes版本构建：

bash
KUBE_VERSION=<desired_version> make build

credits

该项目由@mumoshu、@kylegato和@egeland共同维护，基于初始工作和增强版本整合而成。 ===END===