sukeesh/k8s-job-notify

Kubernetes Job/CronJob 通知工具

https://img.shields.io/***/url?style=social&url=https%3A%2F%2Fgithub.com%2Fsukeesh%2Fk8s-job-notify](https://***.com/intent/tweet?url=https%3A%2F%2Fgithub.com%2Fsukeesh%2Fk8s-job-notify)

 !GitHub commit activity

镜像概述

本工具用于监控Kubernetes集群中的Job和CronJob执行状态，当任务成功或失败时向Slack发送警报。部署到集群时无需额外复杂设置，仅需应用提供的Kubernetes部署清单即可，工具通过InClusterConfig直接访问Kubernetes API。

核心功能

1. 实时监控Job/CronJob的成功/失败状态并发送Slack通知
2. 支持InClusterConfig模式，无需外部KubeConfig文件
3. 适配RBAC权限体系，可通过ServiceAccount获取资源访问权限
4. 支持添加集群名称参数，便于多集群环境下区分通知来源

使用场景

• 监控定时任务（CronJob）执行结果，及时发现失败任务
• 跟踪一次性任务（Job）完成状态，确保关键业务流程正常
• 多集群管理时，快速识别不同集群的任务执行情况

配置说明

环境变量

• webhook: Slack webhook URL（建议通过Secret安全存储）
• namespace: 需监控的目标命名空间（可通过fieldRef自动获取当前命名空间）
• incluster: 设置为1启用InClusterConfig模式

参数配置

• --cluster-name=<your-cluster-name>: 在通知消息中添加集群名称标识

RBAC配置（可选）

若集群启用RBAC，需创建以下资源以授予工具读取Job的权限：

yaml
---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: k8s-job-notify
  namespace: <namespace_name>

---
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
  namespace: <namespace_name>
  name: job-reader
rules:
  - apiGroups: ['batch']
    resources: [jobs]
    verbs: [get, list, watch]

---
apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
  name: k8s-job-notify
  namespace: <namespace_name>
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: Role
  name: job-reader
subjects:
  - kind: ServiceAccount
    name: k8s-job-notify
    namespace: <namespace_name>

部署示例

Kubernetes Deployment清单

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  labels: {app: kjn}
  name: k8s-job-notify
  namespace: <namespace_name>
spec:
  replicas: 1
  selector: {matchLabels: {app: kjn}}
  template:
    metadata:
      annotations: {sidecar.istio.io/inject: 'false'}
      labels: {app: kjn}
    spec:
      # serviceAccountName: k8s-job-notify（需配合RBAC配置）
      containers:
        - env:
            - name: webhook
              value: <slack_webhook_url>
            - name: namespace
              valueFrom: {fieldRef: {fieldPath: metadata.namespace}}
            - name: incluster
              value: '1'
          image: sukeesh/k8s-job-notify:<tag>
          name: k8s-job-notify
          resources:
            limits: {cpu: 500m, memory: 256Mi}
            requests: {cpu: 500m, memory: 128Mi}

添加集群名称示例

yaml
containers:
  image: sukeesh/k8s-job-notify:<tag>
  name: k8s-job-notify
  args: ['--cluster-name=prod-cluster']

版本选择

• 稳定版：使用GitHub Release标签（如1.2）
• 测试版：使用beta标签（主分支更新时自动构建）

许可证

本项目采用MIT许可证，详情请参考项目仓库。