把Terraform通知扩展到Slacktfnotify双通道通知与线程回复完整教程【免费下载链接】tfnotifyA CLI command to parse Terraform execution result and notify it to GitHub项目地址: https://gitcode.com/gh_mirrors/tf/tfnotifytfnotify是一个 Go 语言编写的 Terraform 执行结果通知工具它会捕获terraform plan/terraform apply的输出含退出码与错误详情解析结果后推送到 GitHub 评论或Slack 频道支持双通道同时通知和 Slack 线程回复。本教程带你从零完成 Slack 通知配置。一、为什么需要 Terraform 通知工具Terraform 的plan和apply经常跑在 CIGitHub Actions、CloudBuild、CircleCI 等里。命令失败了你还得翻进 CI 日志页才能看到结果——非常麻烦。tfnotify 解决的就是这个问题GitHub 通道把 plan/apply 结果以评论形式发到 Pull Request 上还能自动打 label、加资源将被删除警告Slack 通道把失败摘要推送到指定频道支持线程回复收纳完整错误详情双通道并存同一个 CI 任务里PR 评论 Slack 告警一次搞定AI 摘要可选接入 AI 对变更做摘要分析Slack 通知的完整实现位于 pkg/notifier/slack/核心配置结构见 pkg/config/config.go。二、Slack 通知的 5 个核心配置项tfnotify 的 Slack 配置写在tfnotify.yaml的notifier.slack下参考 pkg/notifier/slack/slack.go 中的 Config 定义配置项作用说明enabled开启 Slack 通知设为true后与 GitHub 通知并行工作notify_on_plan_errorplan 失败时通知默认关闭只在失败时提醒notify_on_apply_errorapply 失败时通知默认关闭use_threads启用线程回复默认开启长输出收进子线程plan_title/apply_title消息标题支持 Go 模板变量几个容易踩坑的点Token 和频道 ID 不写在配置文件里tfnotify 从环境变量SLACK_BOT_TOKEN、SLACK_CHANNEL_ID可选SLACK_BOT_NAME读取见 pkg/controller/controller.go。这样避免密钥泄露到代码仓库线程默认开启不设use_threads时默认为true也可用环境变量SLACK_USE_THREADSfalse覆盖只报失败不打扰成功时不会发 Slack 消息只有失败才告警源码中有回归测试专门保证这一点见 pkg/notifier/slack/slack_test.go三、一键配置双通道通知示例下面是一个同时启用 GitHub Slack 的完整tfnotify.yaml配置GitHub 部分基于 example.tfnotify.yaml 整理ci: owner: - type: envsubst value: your-org repo: - type: envsubst value: your-repo notifier: github: token: $GITHUB_TOKEN repository: owner: your-org name: your-repo slack: enabled: true notify_on_plan_error: true notify_on_apply_error: true use_threads: true plan_title: Terraform Plan apply_title: ️ Terraform Apply terraform: plan: template: | ## Plan Result {{if .Result}} precode{{ .Result }} /pre/code {{end}}然后在 CI 中设置 3 个环境变量即可环境变量值从哪来SLACK_BOT_TOKENSlack 应用的 Bot Tokenxoxb-...SLACK_CHANNEL_ID频道 IDC...在 Slack 频道详情里获取SLACK_BOT_NAME可选机器人显示名运行方式不变——tfnotify 从标准输入读取 Terraform 输出$ terraform plan | tfnotify plan $ terraform apply | tfnotify apply四、线程回复为什么强烈建议开启Slack 单条消息最长 4 万字符而一次完整的 Terraform 错误输出可能很长。tfnotify 的线程策略见 pkg/notifier/slack/plan.go主消息父消息只发标题 ❌ Terraform plan failed. See thread for details.醒目但不刷屏子线程完整错误结果以代码块形式回复在父消息的线程里这样频道里只留一条简短的告警团队点开线程即可看细节讨论也自然聚合在线程内。另外tfnotify 还会自动做两件事保护消息完整性超长文本自动截断并附加... (output truncated by tfnotify)标记自动转义等特殊字符保证 Slack 的 mrkdwn 格式正确相关逻辑见 pkg/notifier/slack/slack.go。五、进阶玩法1. 按环境区分标题SLACK_PLAN_TITLE、SLACK_PLAN_MESSAGE环境变量可覆盖配置文件中的标题pkg/controller/controller.go方便同一份配置区分 staging / production 环境。2. 搭配 AI 摘要在配置中开启ai_summary后失败通知会附带 AI 生成的变更摘要支持多家模型服务商。实现位于 pkg/ai/AI 摘要配置结构见 pkg/config/config.go。3. 其他通知渠道除了 GitHub 和 Slacktfnotify 还支持本地文件输出pkg/notifier/localfile/方便做审计留档。六、快速检查清单 ✅CI 中已设置SLACK_BOT_TOKEN和SLACK_CHANNEL_IDtfnotify.yaml中slack.enabled: true按需开启notify_on_plan_error/notify_on_apply_erroruse_threads保持默认true让错误详情收进线程本地先跑一次terraform plan | tfnotify plan验证配置完成后下次 Terraform 在 CI 中失败你会同时收到PR 上的详细评论和Slack 频道里的告警线程——再也不用手动翻 CI 日志了 【免费下载链接】tfnotifyA CLI command to parse Terraform execution result and notify it to GitHub项目地址: https://gitcode.com/gh_mirrors/tf/tfnotify创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考