github-actions

GitHub Actions 通知与 ChatOps：Slack/钉钉/飞书集成与评论触发工作流

系统讲解 GitHub Actions 的通知集成与 ChatOps 实践，涵盖 Slack/钉钉/飞书/企业微信的多平台消息推送、PR 状态实时通报、部署结果通知，以及通过 Issue/PR 评论触发工作流的 ChatOps 机器人实现，帮助团队将 CI/CD 状态透明化并提升协作效率。

Leeting Yan 2026-09-22 6 分钟阅读 2894 字

CI/CD 流水线如果只有开发者主动打开 GitHub 才能看到状态，信息的流动效率就大打折扣。一个理想的 DevOps 团队应该让 CI/CD 状态「 push 到每个人面前」——PR 提交时通知评审人、测试失败时通知提交者、部署成功后通知团队、生产故障时通知值班人员。本文将系统讲解 GitHub Actions 与主流即时通讯平台的集成方案，以及通过评论触发工作流的 ChatOps 实践，让 CI/CD 成为团队协作的「主动广播者」。

一、通知集成的架构模型

1.1 信息流向设计

GitHub Event (push/pr/check_run/deploy)
         │
         ▼
┌─────────────────┐
│  GitHub Actions │
│  Workflow       │
│                 │
│  ┌───────────┐  │
│  │ 条件过滤   │  │  ← 只通知关键事件
│  │ (success/ │  │
│  │  failure/ │  │
│  │  deploy)  │  │
│  └─────┬─────┘  │
│        ▼        │
│  ┌───────────┐  │
│  │ 消息格式化 │  │  ← Markdown/卡片/Rich Text
│  └─────┬─────┘  │
│        ▼        │
│  ┌───────────┐  │
│  │ 多平台推送 │  │  ← Slack/钉钉/飞书/邮件
│  └───────────┘  │
└─────────────────┘

1.2 通知策略矩阵

事件	通知对象	紧急度	通道
PR 创建	代码评审人	低	群机器人
CI 测试失败	PR 作者 + 最近修改者	高	个人 + 群
部署到 staging	团队群	中	群机器人
部署到 production	团队群 + 值班人员	高	群 + 个人 + 电话
安全漏洞扫描发现	安全团队	紧急	群 + 个人 + 邮件
定时任务失败	运维团队	高	群 + 邮件

二、Slack 集成

2.1 创建 Slack Incoming Webhook

在 Slack 应用管理中：

访问 Slack API → Create New App
选择「From scratch」→ 输入应用名称
导航到 Incoming Webhooks → 激活 → Add New Webhook to Workspace
选择目标频道 → 复制 Webhook URL（格式：https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXX）

将 URL 存入 GitHub Secrets：SLACK_WEBHOOK_URL

2.2 Slack 通知 workflow

name: Notify Slack
on:
  push:
    branches: [main]
  pull_request:
    types: [opened, closed]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - name: Notify Slack on PR
        if: github.event_name == 'pull_request'
        uses: slackapi/slack-github-action@v1
        with:
          payload: |
            {
              "text": "📋 新 Pull Request",
              "blocks": [
                {
                  "type": "section",
                  "text": {
                    "type": "mrkdwn",
                    "text": "*<${{ github.event.pull_request.html_url }}|${{ github.event.pull_request.title }}>*\n由 ${{ github.event.pull_request.user.login }} 提交"
                  }
                },
                {
                  "type": "context",
                  "elements": [
                    {
                      "type": "mrkdwn",
                      "text": "🔄 ${{ github.event.pull_request.changed_files }} 个文件变更 | ➕ ${{ github.event.pull_request.additions }} 行增加 | ➖ ${{ github.event.pull_request.deletions }} 行删除"
                    }
                  ]
                }
              ]
            }
        env:
          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}

      - name: Notify Slack on Deploy Success
        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
        uses: slackapi/slack-github-action@v1
        with:
          payload: |
            {
              "text": "🚀 部署成功",
              "attachments": [
                {
                  "color": "good",
                  "fields": [
                    {
                      "title": "仓库",
                      "value": "${{ github.repository }}",
                      "short": true
                    },
                    {
                      "title": "提交",
                      "value": "<${{ github.event.head_commit.url }}|${{ github.event.head_commit.message }}>",
                      "short": true
                    }
                  ]
                }
              ]
            }
        env:
          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}

2.3 Slack Block Kit 富文本消息

Slack 支持丰富的 Block Kit 格式：

{
  "blocks": [
    {
      "type": "header",
      "text": {
        "type": "plain_text",
        "text": "🚀 Production Deploy"
      }
    },
    {
      "type": "section",
      "fields": [
        {
          "type": "mrkdwn",
          "text": "*Repository:*\nmy-org/my-app"
        },
        {
          "type": "mrkdwn",
          "text": "*Branch:*\nmain"
        },
        {
          "type": "mrkdwn",
          "text": "*Commit:*\nabc1234"
        },
        {
          "type": "mrkdwn",
          "text": "*Duration:*\n4m 32s"
        }
      ]
    },
    {
      "type": "actions",
      "elements": [
        {
          "type": "button",
          "text": {
            "type": "plain_text",
            "text": "View Deployment"
          },
          "url": "https://github.com/my-org/my-app/deployments"
        }
      ]
    }
  ]
}

三、钉钉集成

3.1 创建钉钉群机器人

打开钉钉群 → 群设置 → 智能群助手 → 添加机器人
选择「自定义」→ 输入机器人名称
勾选「安全设置」→ 选择「加签」或「IP 地址（段）」
复制 Webhook 地址

将 Webhook URL 和加签密钥存入 GitHub Secrets。

3.2 加签算法（Python 示例）

钉钉要求对请求进行加签：

import time
import hmac
import hashlib
import base64

def generate_sign(secret):
    timestamp = str(round(time.time() * 1000))
    string_to_sign = f'{timestamp}\n{secret}'
    hmac_code = hmac.new(secret.encode('utf-8'), string_to_sign.encode('utf-8'), digestmod=hashlib.sha256).digest()
    sign = base64.b64encode(hmac_code).decode('utf-8')
    return timestamp, sign

3.3 钉钉通知 workflow

name: Notify DingTalk
on:
  push:
    branches: [main]
  pull_request:
    types: [opened]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - name: Send DingTalk notification
        run: |
          TIMESTAMP=$(python3 -c "
import time, hmac, hashlib, base64
secret = '${{ secrets.DINGTALK_SECRET }}'
timestamp = str(round(time.time() * 1000))
string_to_sign = f'{timestamp}\n{secret}'
hmac_code = hmac.new(secret.encode('utf-8'), string_to_sign.encode('utf-8'), digestmod=hashlib.sha256).digest()
sign = base64.b64encode(hmac_code).decode('utf-8')
print(f'{timestamp},{sign}')
          ")
          
          TS=$(echo $TIMESTAMP | cut -d',' -f1)
          SIGN=$(echo $TIMESTAMP | cut -d',' -f2)
          
          curl -X POST "${{ secrets.DINGTALK_WEBHOOK }}&timestamp=$TS&sign=$SIGN" \
            -H 'Content-Type: application/json' \
            -d '{
              "msgtype": "markdown",
              "markdown": {
                "title": "GitHub Actions 通知",
                "text": "### 🚀 部署通知\n\n**仓库**: ${{ github.repository }}\n**分支**: ${{ github.ref_name }}\n**提交**: ${{ github.event.head_commit.message }}\n**作者**: ${{ github.event.head_commit.author.name }}\n\n[查看详情](${{ github.event.head_commit.url }})"
              }
            }'

四、飞书集成

4.1 创建飞书群机器人

打开飞书群 → 设置 → 群机器人 → 添加机器人
选择「自定义机器人」→ 输入名称
复制 Webhook 地址

4.2 飞书通知 workflow

name: Notify Feishu
on:
  push:
    branches: [main]

jobs:
  notify:
    runs-on: ubuntu-latest
    steps:
      - name: Send Feishu notification
        run: |
          curl -X POST "${{ secrets.FEISHU_WEBHOOK }}" \
            -H 'Content-Type: application/json' \
            -d '{
              "msg_type": "interactive",
              "card": {
                "header": {
                  "title": {
                    "tag": "plain_text",
                    "content": "🚀 Production Deployment"
                  },
                  "template": "green"
                },
                "elements": [
                  {
                    "tag": "div",
                    "text": {
                      "tag": "lark_md",
                      "content": "**Repository:** ${{ github.repository }}\n**Branch:** ${{ github.ref_name }}\n**Commit:** ${{ github.sha }}"
                    }
                  },
                  {
                    "tag": "action",
                    "actions": [
                      {
                        "tag": "button",
                        "text": {
                          "tag": "plain_text",
                          "content": "查看部署"
                        },
                        "url": "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}",
                        "type": "primary"
                      }
                    ]
                  }
                ]
              }
            }'

五、ChatOps：通过评论触发工作流

5.1 核心原理

on:
  issue_comment:
    types: [created]

当有人在 Issue 或 PR 上发表评论时，这个事件会触发 workflow。通过解析评论内容，可以实现「命令式」操作。

5.2 实现 /deploy 命令

name: ChatOps Deploy
on:
  issue_comment:
    types: [created]

jobs:
  deploy:
    if: github.event.issue.pull_request && contains(github.event.comment.body, '/deploy')
    runs-on: ubuntu-latest
    steps:
      - name: Acknowledge command
        run: |
          curl -X POST \
            -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
            -H "Accept: application/vnd.github.v3+json" \
            "${{ github.event.issue.comments_url }}" \
            -d '{"body": "🚀 收到部署命令，正在执行..."}'

      - uses: actions/checkout@v4
        with:
          ref: refs/pull/${{ github.event.issue.number }}/head

      - name: Deploy to staging
        run: ./scripts/deploy.sh staging

      - name: Report result
        if: always()
        run: |
          STATUS=$(if [ "${{ job.status }}" == "success" ]; then echo "✅ 部署成功"; else echo "❌ 部署失败"; fi)
          curl -X POST \
            -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
            -H "Accept: application/vnd.github.v3+json" \
            "${{ github.event.issue.comments_url }}" \
            -d "{\"body\": \"$STATUS ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}\"}"

5.3 权限控制

ChatOps 的最大风险是任何人都可以触发命令。建议加上权限检查：

jobs:
  deploy:
    if: |
      github.event.issue.pull_request &&
      contains(github.event.comment.body, '/deploy') &&
      (github.event.comment.author_association == 'OWNER' ||
       github.event.comment.author_association == 'MEMBER')

author_association 的可能值包括：OWNER、MEMBER、COLLABORATOR、CONTRIBUTOR、FIRST_TIME_CONTRIBUTOR、FIRST_TIMER、NONE。

5.4 更多 ChatOps 命令示例

命令	功能	触发 workflow
`/deploy`	部署当前 PR 到 staging	`issue_comment`
`/test`	重新运行测试	`issue_comment`
`/approve`	审批合并（替代人工点击）	`issue_comment`
`/revert`	回滚上一次部署	`issue_comment`
`/benchmark`	运行性能基准测试	`issue_comment`

六、通知降噪与频率控制

6.1 常见噪音来源

噪音类型	问题	解决方案
每次 push 都通知	开发阶段噪音大	只在 push 到 main / 特定分支时通知
PR 每个 commit 都通知	reviewer 被轰炸	只在 PR 创建/关闭/合并时通知
失败的 flaky test	反复通知同样的问题	失败 3 次后再通知
成功通知淹没失败	失败被忽略	成功用灰色，失败用红色

6.2 条件过滤实践

- name: Smart notification
  if: |
    failure() ||
    (github.ref == 'refs/heads/main' && github.event_name == 'push') ||
    (github.event_name == 'pull_request' && github.event.action == 'opened')
  run: |
    # 只有失败、main 分支推送或新 PR 才通知

6.3 聚合通知

对于频繁的定时任务，可以按天/周聚合通知：

name: Daily Status Report
on:
  schedule:
    - cron: '0 9 * * 1-5'  # 工作日上午 9 点

jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - name: Generate daily summary
        run: |
          # 统计过去 24 小时的构建数据
          echo "📊 昨日构建统计" > report.txt
          echo "SUCCESS: ${{ steps.stats.outputs.success }}" >> report.txt
          echo "FAILURE: ${{ steps.stats.outputs.failure }}" >> report.txt

      - name: Send to Slack
        uses: slackapi/slack-github-action@v1
        with:
          payload: |
            {"text": "$(cat report.txt)"}
        env:
          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}

七、常见问题解答（FAQ）

Q1: PR review comment 会触发 issue_comment 吗？

不会。issue_comment 只触发于 PR 的「普通评论」，review comment 使用 pull_request_review_comment 事件。如需监听 review comment：

on:
  pull_request_review_comment:
    types: [created]

Q2: 如何@特定用户？

Slack：使用 <@USER_ID> 格式。需要先通过 Slack API 获取用户 ID。

钉钉：使用 @手机号 格式，但需要在群设置中开启「@所有人」权限。

飞书：使用 <at id="USER_ID"></at> 格式。

Q3: 通知失败了会影响 workflow 吗？

不会，除非你在 notification step 中设置了 exit 1。建议通知 step 使用 continue-on-error: true：

- name: Notify Slack
  continue-on-error: true
  uses: slackapi/slack-github-action@v1
  with:
    payload: '{"text": "test"}'

Q4: 如何实现「审批后才能部署」的通知流程？

结合 GitHub Environments 的 protection rules：

jobs:
  deploy-production:
    runs-on: ubuntu-latest
    environment: production  # 触发审批
    steps:
      - run: ./deploy.sh production

当 workflow 到达 environment 这一步时，会通知配置的审批人，审批通过后才会继续执行。

总结

通知与 ChatOps 不是 CI/CD 的「附加功能」，而是驱动团队协作的信息基础设施。一个设计良好的通知系统应该遵循三个原则：

原则	实践
正确的人	按角色和事件类型路由通知（作者 → 失败，团队 → 发布）
正确的时机	关键事件实时推，日常事件批量报，成功静默失败告警
正确的通道	紧急用强提醒（电话/短信），日常用弱提醒（群机器人）

ChatOps 则把「查看 CI 状态」从被动行为变成主动交互，让开发者在不离开聊天工具的情况下完成部署、测试、回滚等操作。两者结合，CI/CD 从一个「后台工具」进化为「团队协作的中央枢纽」。

延伸阅读：

GitHub Actions 发布自动化 — 部署成功后的自动通知触发
GitHub Actions OIDC 云认证 — ChatOps 部署命令的安全认证
DevOps 监控与告警专题 — 生产环境告警体系设计

继续阅读

探索更多技术文章

浏览归档，发现更多关于系统设计、工具链和工程实践的内容。

全部文章返回首页