tfgco/fluxcloud

镜像概述

FluxCloud是TopFreeGames分叉的开源工具，作为Weave Flux的上游服务，可接收Kubernetes集群状态管理工具Weave Flux的事件，并将其转发至Slack、Microsoft Teams、Mattermost、Datadog或自定义Webhook，帮助团队实时获取集群部署变化通知，无需使用Weave Cloud服务。

核心功能

• 接收Weave Flux的集群事件（如部署更新、镜像同步）
• 支持多渠道通知：Slack、Microsoft Teams、Mattermost、Datadog、Webhook
• 自定义事件格式：通过模板文件或环境变量修改标题、正文、提交信息的展示方式
• 多频道通知：Slack支持按Kubernetes命名空间区分通知频道
• 链路追踪：可选集成Jaeger上报事件追踪数据

使用场景

• Kubernetes集群中Flux部署更新的团队实时通知
• 集群状态变化数据同步至Datadog进行监控分析
• 自定义Webhook集成到内部运维系统
• 跨团队按命名空间分发集群事件通知

配置说明

部署方式

支持两种部署模式：

1. Sidecar模式：与Flux部署在同一Pod中，参考examples/flux-deployment-sidecar.yaml
2. 独立部署：单独创建Deployment，参考examples/fluxcloud.yaml

关键环境变量

需配置以下环境变量（根据使用的通知渠道选择）：

• SLACK_URL：Slack Incoming Webhook URL
• SLACK_CHANNEL：Slack通知频道（多频道格式：#k8s-events=*,#team-b=team-b）
• MSTEAMS_URL：Microsoft Teams Webhook URL
• MATTERMOST_URL：Mattermost Webhook URL
• DATADOG_API_KEY/DATADOG_APP_KEY：Datadog API密钥
• WEBHOOK_URL：自定义Webhook接收地址
• EXPORTER_TYPE：通知类型（可选值：slack, msteams, datadog, webhook，默认slack）

部署示例

1. 应用FluxCloud配置：

bash
kubectl apply -f examples/fluxcloud.yaml

2. 修改Flux部署的--connect参数，指向FluxCloud服务：

bash
# 在Flux的Deployment中添加参数
--connect=ws://fluxcloud

模板自定义

通过以下方式修改事件展示格式：

• 在工作目录创建templates文件夹，放置body.tmpl、title.tmpl、commit.tmpl文件（优先级高于环境变量）
• 使用环境变量BODY_TEMPLATE、TITLE_TEMPLATE、COMMIT_TEMPLATE直接设置模板内容

示例：修改Commit链接为Bitbucket格式

bash
export COMMIT_TEMPLATE="{{ .VCSLink }}/commits/{{ .Commit }}"