dhpizza/concourse-to-teams-hook-image

concourse-teams-resource镜像说明

镜像概述

本镜像实现了Concourse CI/CD管道与Microsoft Teams频道的集成，允许管道在任务执行状态变化时向Teams发送通知，帮助团队实时掌握CI/CD流程进展。

核心功能

1. 支持发送任务成功或失败状态的通知
2. 可添加自定义附加链接及显示名称
3. 与Concourse资源类型无缝兼容，易于集成到现有管道

使用场景

• 当Concourse管道中的构建任务失败时，自动向团队Teams频道发送告警
• 重要任务执行成功时，向相关人员发送通知
• 结合附加链接提供构建详情或相关资源的快速访问入口

配置说明

1. 定义资源类型

在Concourse pipeline配置中添加teams-notification资源类型：

yaml
resource_types:
- name: teams-notification
  type: docker-image
  source:
    repository: dhpizza/concourse-to-teams-hook-image
    tag: latest

2. 配置通知资源

指定Teams频道的webhook URL：

yaml
resources:
- name: alert
  type: teams-notification
  source:
    url: <your-microsoft-teams-webhook-url>

3. 任务中触发通知

在job的on_failure或on_success阶段发送通知：

yaml
jobs:
- name: teams-notification
  serial: true
  on_failure:
    do:
    - put: alert
      params:
        status: failure                   # 必选，可选值：success/failure
        additionalLinkFile: src/url.txt   # 可选，包含附加链接的文件路径
        additionalLinkName: "查看详情"    # 可选，附加链接的显示名称
  plan:
  - task: test-task
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: alpine}
      run:
        path: sh
        args: [-exc, "exit 1"]

以上配置将在任务失败时向指定Teams频道发送包含失败状态及附加链接的通知。 ===FULL_DESC===