flexys/slack-notification-resource

Slack通知资源镜像

该镜像为Concourse CI提供Slack通知资源，用于在CI/CD流程中向Slack发送消息，支持多种消息形式和自定义配置。

核心功能

• 发送静态文本或文件中的文本内容到Slack
• 支持消息附件（可通过参数或文件指定）
• 自定义发送频道、发送者名称、图标（URL或表情符号）
• 支持元数据变量插值，动态生成消息内容
• 可选跳过SSL验证或配置CA证书

使用场景

• CI/CD pipeline构建成功/失败通知
• 代码提交、部署状态更新通知
• 异常事件告警（如测试失败、资源不足）

配置说明

资源类型配置

在Concourse pipeline中定义资源类型：

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

源配置

需先在Slack创建incoming webhook，获取webhook URL：

yaml
resources:
- name: slack-alert
  type: slack-notification
  source:
    url: https://hooks.slack.com/services/XXXX  # 必填：Slack webhook URL
    insecure: false  # 可选：是否跳过SSL验证，默认false
    ca_certs:  # 可选：信任的CA证书列表
    - domain: example.com
      cert: |
        -----BEGIN CERTIFICATE-----
        ...
        -----END CERTIFICATE-----

行为：发送消息（out）

通过put步骤发送消息到Slack，参数说明：

必填参数（至少选一个）

• text：静态消息文本
• text_file：包含消息文本的文件路径
• attachments：消息附件数组（遵循Slack附件格式）
• attachments_file：包含附件数组的JSON文件路径

可选参数

• channel：指定发送频道（如#dev或@user，支持多个）
• channel_file：包含频道列表的文件路径
• username：自定义发送者名称
• icon_url：自定义图标URL
• icon_emoji：自定义图标表情（如:ghost:）
• silent：是否隐藏curl输出（避免泄露webhook URL）
• always_notify：即使有错误或缺失文本也尝试通知（默认false）

元数据使用

可通过环境变量插入Concourse元数据（如构建ID、流水线名称）：

yaml
jobs:
- name: build-notify
  plan:
  - put: slack-alert
    params:
      channel: '#dev-team'
      text: |
        构建结果：$TEXT_FILE_CONTENT
        流水线：$BUILD_PIPELINE_NAME
        构建链接：http://concourse.example.com/builds/$BUILD_ID
      text_file: results/build_result.txt

示例

1. 静态文本消息：

yaml
params:
  text: "构建成功！"

2. 从文件读取文本：

yaml
params:
  text_file: results/message.txt

3. 带附件的消息：

yaml
params:
  attachments:
  - title: "构建报告"
    text: "测试通过率：95%"
    color: "#2ECC71"