delmonte3161/teams-notification-resource

Concourse CI Teams通知资源

该镜像实现了Microsoft Teams连接器协议与Concourse CI资源协议，用于在Concourse CI管道中向指定Teams频道发送通知消息。

核心功能

• 支持从Concourse CI管道发送消息到Teams频道
• 运行时解析Concourse环境变量（如$BUILD_ID、$BUILD_PIPELINE_NAME等）
• 自定义消息文本、标题、颜色及操作按钮链接
• 通过textFile参数读取任务生成的文件内容作为消息
• 临时禁用通知（disable参数）

使用场景

• CI/CD pipeline执行成功/失败通知
• 重要任务完成状态同步
• 管道运行结果实时推送至团队沟通频道

配置说明

资源类型定义

在Concourse pipeline中需先声明资源类型：

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

源配置

yaml
resources:
- name: alert
  type: teams-notification
  source:
    url: https://outlook.office365.com/webhook/your-webhook-url  # 必需，Teams Incoming Webhook URL
    disable: false  # 可选，是否禁用通知，默认false

参数配置示例

在任务的on_success/on_failure阶段发送通知：

yaml
- name: Test-Pull-Request
  plan:
  - get: repo-pr
    trigger: true
  - task: test-pr
    file: repo-pr/pipeline/test-pr.yml
    on_success:
      put: alert
      params:
        text: "拉取请求测试通过：无错误"
        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: "拉取请求测试失败：**存在错误**"
        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：可选，消息内容文件路径（结合$TEXT_FILE_CONTENT使用）
• tailLines：可选，textFile尾部读取行数（默认10）
• color：可选，标题颜色（如EA4300为红色）
• actionName：可选，操作按钮文本
• actionTarget：可选，操作按钮链接URL