watawuwu/slack-notification-resource

Slack通知资源（Concourse CI自定义资源）

镜像概述

本镜像为Concourse CI的自定义资源类型，用于在CI/CD流程中向Slack发送通知。相比社区原版cloudfoundry-community/slack-notification-resource，新增了线程通知功能，可将消息回复到指定线程中。

核心功能

• 向Slack发送消息（支持普通消息和附件形式）
• 支持线程回复功能（通过thread_ts_file参数）
• 允许从文件读取附件内容或频道列表
• 支持动态参数替换（使用Concourse元数据环境变量）
• 可覆盖发送频道、用户名、图标等配置

使用场景

• CI/CD构建成功/失败状态通知
• 应用部署结果推送
• 流程异常告警
• 重要操作日志同步到Slack频道

配置说明

资源类型配置

在Concourse pipeline中定义资源类型：

yaml
resource_types:
- name: slack-notification
  type: docker-image
  source:
    repository: watawuwu/slack-notification-resource
    tag: latest

源配置

需配置Slack OAuth2.0访问令牌：

yaml
resources:
- name: notification
  type: slack-notification
  source:
    token: xoxp-xxxxxxxxxx-xxxxxxxxxxx-xxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

说明：token为必填项，需从Slack应用管理页面获取。

行为说明

in：获取最新线程ID

获取该资源上次发送消息的thread_ts（线程ID），并写入.thread_ts文件。
限制：线程ID按资源维度存储，若多个任务同时发送，会获取最后一次发送的线程ID；如需避免，可按任务单独定义资源（不推荐）。

out：发送消息到Slack

发送消息到Slack，支持以下参数：

必填参数（二选一）：

• attachments：消息附件数组（遵循Slack附件格式）
• attachments_file：包含附件数组的文件路径（优先级低于attachments）

可选参数：

• channel：覆盖发送频道（支持#channel或@user，多个以空格分隔）
• channel_file：包含频道列表的文件路径（与channel参数内容合并）
• username：覆盖发送者名称
• icon_url：覆盖图标（通过URL）
• icon_emoji：覆盖图标（通过emoji代码，如:ghost:）
• thread_ts_file：指定线程ID文件（实现线程回复）
• reply_broadcast：将线程回复广播到频道（实验性）

示例配置

以下是Concourse job中使用该资源的示例：

yaml
jobs:
- name: build-notification
  plan:
  - put: notification
    params:
      channel: '#ci-builds'
      attachments: |
        [{
          "color": "good",
          "title": "构建成功",
          "title_link": "https://$CONCOURSE_URL/teams/$BUILD_TEAM_NAME/pipelines/$BUILD_PIPELINE_NAME/jobs/$BUILD_JOB_NAME/builds/$BUILD_NAME",
          "text": "项目构建完成，状态：成功"
        }]

说明：$CONCOURSE_URL等变量为Concourse内置元数据，可动态替换为实际值。