richardg0510/teams-notification-resource

Concourse CI Teams通知资源

镜像概述

该镜像基于navicore/teams-notification-resource构建，实现了Microsoft Teams连接器协议与Concourse CI资源协议，可在Concourse CI管道中向指定Teams频道发送通知消息。

核心功能

• 向Microsoft Teams频道发送自定义MessageCard格式消息
• 运行时解析Concourse CI环境变量（如$BUILD_ID、$BUILD_PIPELINE_NAME等）并替换到消息中
• 遵循Concourse资源规范，支持在管道任务的成功/失败等事件触发通知

使用场景

• CI管道执行结果（成功/失败）实时通知到Teams团队频道
• 关键构建或部署步骤完成提醒
• 构建状态同步到团队协作空间

配置说明

Teams端前置设置

1. 打开Microsoft Teams，选择目标频道
2. 点击频道“更多选项”→“连接器”
3. 选择“传入Webhook”，配置名称和图标后获取Webhook URL

Concourse管道配置示例

资源类型定义

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

资源定义

yaml
resources:
- name: teams-alert
  type: teams-notification
  source:
    url: https://outlook.office365.com/webhook/你的WebhookURL # 替换为Teams获取的URL

任务中触发通知（失败通知示例）

yaml
jobs:
- name: test-job
  plan:
  - get: repo
    trigger: true
  - task: run-test
    file: repo/test.yml
    on_failure:
      put: teams-alert
      params:
        message: |
          "{
            \"@type\": \"MessageCard\",
            \"@context\": \"http://schema.org/extensions\",
            \"summary\": \"测试任务失败\",
            \"themeColor\": \"FF0000\",
            \"title\": \"$BUILD_PIPELINE_NAME/$BUILD_JOB_NAME任务失败\",
            \"sections\": [
              {
                \"text\": \"构建失败：$BUILD_PIPELINE_NAME/$BUILD_JOB_NAME\",
                \"facts\": [
                  {\"name\": \"团队\", \"value\": \"$BUILD_TEAM_NAME\"},
                  {\"name\": \"构建链接\", \"value\": \"[$ATC_EXTERNAL_URL/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME]($ATC_EXTERNAL_URL/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME)\"}
                ]
              }
            ]
          }"

参数说明

• source.url: 必选，Teams传入Webhook的URL
• params.message: 必选，JSON格式的消息卡片内容，需正确转义引号，支持Concourse环境变量替换