stossington/concourse-msteams-notification-resource

Concourse CI Teams通知资源

镜像概述

本镜像实现了Microsoft Teams连接器协议和Concourse CI资源协议，用于从Concourse CI流水线向指定Microsoft Teams频道发送通知消息，帮助团队实时监控流水线构建状态。

核心功能

• 向Teams频道发送包含自定义文本、标题的消息（支持Markdown格式）
• 解析Concourse CI环境变量（如$BUILD_ID、$BUILD_JOB_NAME等）
• 支持自定义消息侧边栏颜色及按钮链接
• 适配Concourse CI资源协议，可在流水线成功/失败事件中触发通知

使用场景

• DevOps团队监控Concourse流水线构建结果，实时获取成功/失败通知
• 团队协作中同步流水线关键事件到Teams频道，提升沟通效率

配置说明

资源类型定义

在流水线中添加资源类型：

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

资源配置（Source）

yaml
resources:
- name: alert
  type: teams-notification
  source:
    url: https://outlook.office365.com/webhook/你的-webhook-url  # Teams频道Webhook URL（必填）

参数配置（Param）

流水线任务中触发通知示例：

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: "拉取请求测试通过：无错误"
        title: "我的流水线 拉取请求测试完成"
        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: "拉取请求测试失败：**存在错误**"
        title: "我的流水线 拉取请求测试完成"
        actionName: "查看流水线"
        actionTarget: "$ATC_EXTERNAL_URL/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME"

参数说明：

• text：消息文本（必填，支持Markdown）
• title：消息标题（可选）
• color：侧边栏颜色（可选）
• actionName：按钮/链接文本（可选）
• actionTarget：按钮/链接目标URL（可选）