bmsoft/teams-notification-resource

Concourse CI Teams通知资源

该镜像作为Concourse CI的资源类型，用于在流水线中向Microsoft Teams发送通知。它实现了Microsoft Teams连接器协议和Concourse CI资源协议，fork自https://github.com/navicore/teams-notification-resource%EF%BC%8C%E6%BA%90%E7%A0%81%E6%89%98%E7%AE%A1%E4%BA%8Ehttps://github.com/BlackTr/teams-notification-resource%E3%80%82

核心功能

• 解析Concourse CI运行时环境变量（如$BUILD_ID、$BUILD_PIPELINE_NAME等）并插入到通知消息中
• 支持自定义消息文本（Markdown格式）、标题、颜色
• 可从文件读取消息内容，并指定显示尾部行数
• 可添加带链接的按钮，方便跳转至流水线详情页

使用场景

• Concourse CI任务成功/失败时向Teams频道发送通知
• 代码合并、PR测试结果等关键事件的实时提醒

配置说明

资源类型定义

在Concourse流水线中需先定义该资源类型：

yaml
resource_types:
- name: teams-notification
  type: docker-image
  source:
    repository: bmsoft/teams-notification-resource
    tag: latest

资源配置

添加通知资源，需提供Teams incoming webhook URL：

yaml
resources:
- name: alert
  type: teams-notification
  source:
    url: https://outlook.office365.com/webhook/你的webhook地址

• url：必填，Teams频道中创建的Incoming Webhook URL。

参数配置示例

在任务的on_success或on_failure中使用该资源发送通知：

yaml
- name: Test-Pull-Request
  plan:
  - get: mypipeline-pull-request
    trigger: true
  - task: test-pr
    file: mypipeline-pull-request/pipeline/test-pr.yml
    on_success:
      put: alert
      params:
        text: "PR测试通过：无错误"
        title: "PR测试完成"
        actionName: "查看流水线"
        actionTarget: "$ATC_EXTERNAL_URL/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME"
    on_failure:
      put: alert
      params:
        color: "EA4300"
        text: "PR测试失败：**存在错误**"
        title: "PR测试完成"
        actionName: "查看流水线"
        actionTarget: "$ATC_EXTERNAL_URL/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME"

参数说明：

• text：必填，消息文本（支持Markdown）
• title：必填，消息标题
• textFile：可选，从文件读取消息内容
• tailLines：可选，textFile的尾部行数（默认10）
• color：可选，标题颜色
• actionName：可选，按钮文本
• actionTarget：可选，按钮跳转URL