willwill/kube-slack

kube-slack

kube-slack是一款针对Kubernetes的监控服务，当集群中的Pod出现故障时，它会向指定的Slack频道发布通知消息，助力运维人员实时掌握集群状态。

镜像概述

kube-slack专注于Kubernetes集群的Pod状态监控，通过与Slack集成实现故障事件的及时告警，提升集群运维效率。

核心功能

• 监控Pod状态，故障时向Slack频道发送通知
• 支持RBAC权限配置，适配启用RBAC的Kubernetes集群
• 可通过环境变量自定义监控参数（如检查频率、告警阈值等）
• 支持Pod注解，实现特定Pod的忽略或指定通知频道

使用场景

• Kubernetes集群日常运维，实时监控Pod故障并及时响应
• 团队协作场景下同步集群异常状态，提升问题处理效率

配置说明

安装步骤

1. 创建Slack Incoming Webhook：

   1. 在Slack界面点击搜索框附近的齿轮按钮（频道设置）
   2. 选择“添加应用或集成”
   3. 搜索“Incoming WebHooks”并点击“添加配置”
   4. 选择通知频道提交，记录生成的Webhook URL

2. （可选）启用RBAC的集群需应用以下清单：

yml
---
kind: ClusterRole
apiVersion: rbac.authorization.k8s.io/v1
metadata:
  name: kube-slack
rules:
- apiGroups: [""]
  resources: ["pods"]
  verbs: ["get", "watch", "list"]
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: kube-slack
  namespace: kube-system
---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRoleBinding
metadata:
  name: kube-slack
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: kube-slack
subjects:
  - kind: ServiceAccount
    name: kube-slack
    namespace: kube-system

3. 部署到集群： 替换SLACK_URL为你的Webhook URL，若用RBAC则取消serviceAccountName注释：

yml
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: kube-slack
  namespace: kube-system
spec:
  replicas: 1
  revisionHistoryLimit: 3
  template:
    metadata:
      annotations:
        scheduler.alpha.kubernetes.io/critical-pod: ""
      labels:
        app: kube-slack
    spec:
     # serviceAccountName: kube-slack
      containers:
      - name: kube-slack
        image: docker.xuanyuan.run/willwill/kube-slack:v4.2.0
        env:
        - name: SLACK_URL
          value: https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
        resources:
          requests:
            memory: 30M
            cpu: 5m
      tolerations:
      - effect: NoSchedule
        key: node-role.kubernetes.io/master
      - key: CriticalAddonsOnly
        operator: Exists

测试方法

创建失败Pod验证通知：

yml
apiVersion: v1
kind: Pod
metadata:
  name: kube-slack-test
spec:
  containers:
  - image: willwill/inexisting
    name: kube-slack-test

环境变量配置

• TICK_RATE：更新频率（默认15秒）
• METRICS_PERCENT：指标告警阈值（默认80%）
• SLACK_CHANNEL：覆盖通知频道
• 更多参数见镜像文档

Pod注解

• kube-slack/ignore-pod：忽略该Pod错误
• kube-slack/slack-channel：指定通知频道

许可证

MIT许可证