airbloc/fluxslack

fluxslack镜像说明

镜像概述

fluxslack镜像基于https://github.com/justinbarrick/fluxcloud%E5%B7%A5%E5%85%B7%E5%AE%9E%E7%8E%B0%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%B0%86Kubernetes%E9%9B%86%E7%BE%A4%E4%B8%ADFlux%E7%9A%84%E4%BA%8B%E4%BB%B6%EF%BC%88%E5%A6%82%E9%95%9C%E5%83%8F%E6%9B%B4%E6%96%B0%E3%80%81%E9%83%A8%E7%BD%B2%E9%85%8D%E7%BD%AE%E5%8F%98%E6%9B%B4%E7%AD%89%EF%BC%89%E9%80%9A%E8%BF%87Webhook%E6%8E%A8%E9%80%81%E5%88%B0%E6%8C%87%E5%AE%9A%E7%9A%84Slack%E9%A2%91%E9%81%93%EF%BC%8C%E5%B8%AE%E5%8A%A9%E5%9B%A2%E9%98%9F%E5%AE%9E%E6%97%B6%E6%8E%8C%E6%8F%A1GitOps%E5%B7%A5%E4%BD%9C%E6%B5%81%E7%9A%84%E7%8A%B6%E6%80%81%E5%8F%98%E5%8C%96%E3%80%82

核心功能

• 实时推送Flux事件到Slack频道，包括镜像同步、部署成功/失败等状态
• 支持自定义集群名称、GitOps仓库链接，方便区分多环境
• 可配置Slack机器人显示名称、通知频道及消息后缀（如@指定成员）
• 允许跳过已知容器仓库的事件通知，减少冗余信息
• 支持链接到Kubernetes Dashboard查看工作负载详情

使用场景

• GitOps工作流监控：团队实时了解集群部署的变更情况
• 部署状态通知：关键服务更新或失败时及时提醒相关人员
• 多集群管理：区分不同集群的Flux事件，便于统一监控

配置说明

环境变量

fluxcloud配置

需为fluxcloud设置以下环境变量：

• EXPORTER_TYPE: webhook
• EXPORTER_URL: http://<fluxslack服务端点>/v1/webhook

若之前已配置过fluxcloud的Slack集成，需删除后再使用本镜像。

部署示例

Docker Run命令

bash
docker run -d \
  --name fluxslack \
  -e SLACK_WEBHOOK_URL="https://hooks.slack.com/services/XXX/YYY/ZZZ" \
  -e CLUSTER_NAME="prod-cluster" \
  -e VCS_ROOT_URL="https://github.com/your-org/gitops-repo" \
  -e SLACK_CHANNEL="#devops-alerts" \
  airbloc/fluxslack

Docker Compose示例

yaml
version: '3'
services:
  fluxslack:
    image: airbloc/fluxslack
    environment:
      SLACK_WEBHOOK_URL: "https://hooks.slack.com/services/XXX/YYY/ZZZ"
      CLUSTER_NAME: "staging-cluster"
      VCS_ROOT_URL: "https://github.com/your-org/staging-gitops"
      SLACK_USER_NAME: "Flux Bot"
      MESSAGE_POSTFIX: "@dev-team"
    ports:
      - "8080:8080"

许可证

fluxslack项目采用MIT许可证，详情见仓库中的LICENSE文件。