fluxcd/notification-controller

notification-controller 镜像文档

概述

notification-controller 是 Flux CNCF 项目的核心组件，作为 GitOps 工具包的事件分发器，负责处理和分发 GitOps 工作流中的各类事件。

主要用途

• 接收来自 Flux 组件（如 source-controller、kustomize-controller 等）的事件
• 对事件进行处理和路由
• 将事件分发到配置的通知渠道（如 Slack、GitHub Issues、Email 等）

核心功能与特性

• 事件处理：接收并解析 GitOps 工作流中的事件（如资源同步状态变化、部署成功/失败等）
• 事件路由：基于规则将事件分发到指定的通知接收者
• 多渠道支持：兼容多种通知服务，满足不同团队的通知需求
• 集成 Flux 生态：与 Flux 其他组件无缝协作，构建完整的 GitOps 工具链

使用场景与适用范围

• Flux 管理的 Kubernetes 集群中，需要实时获取部署状态、同步结果等事件通知的场景
• GitOps 工作流中，团队需要通过通知及时了解应用部署和配置同步情况
• 自动化运维流程中，需基于事件触发后续操作的场景

使用方法与配置说明

基本部署

作为 Flux 生态的一部分，通常通过 Flux 的安装命令部署，独立运行示例：

bash
docker run -d \
  --name notification-controller \
  --network=flux-network \
  -e METRICS_ADDR=:8080 \
  -e HEALTH_PROBE_ADDR=:8081 \
  -e LOG_LEVEL=info \
  fluxcd/notification-controller:latest

配置说明

• 环境变量：

  • METRICS_ADDR：指标暴露地址（默认：:8080）
  • HEALTH_PROBE_ADDR：健康检查地址（默认：:8081）
  • LOG_LEVEL：日志级别（可选：debug、info、warn、error，默认：info）

• 通知规则配置：通过 Kubernetes CRDs（Alert 和 Receiver 资源）定义事件路由规则和通知接收者，具体配置方法可参考 Flux 官方文档。