orangecloudfoundry/slack-notification-resource

Slack通知资源镜像（orangecloudfoundry/slack-notification-resource）

镜像概述

本镜像为OrangeCloudFoundry分叉的Slack通知资源，用于Concourse CI/CD管道中向Slack发送消息，支持静态文本、文件内容、附件等多种消息形式，可灵活配置发送参数，满足CI/CD流程中的通知需求。

核心功能

• 发送静态文本或文件中的文本消息
• 发送静态附件或文件中的附件内容
• 自定义接收频道、发送者用户名、图标（URL或emoji）
• 支持HTTP(S)代理及CA证书配置
• 集成Concourse元数据变量（如构建ID、管道名称等）动态生成消息内容

使用场景

• Concourse管道构建成功/失败通知
• 应用部署状态通知
• 系统错误或异常告警
• 流程进度更新通知

配置说明

资源类型配置

在Concourse管道中定义资源类型：

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

源配置

配置Slack Webhook URL及其他基础参数：

yaml
resources:
- name: slack-alert
  type: slack-notification
  source:
    url: https://hooks.slack.com/services/XXXXXX  # Slack Incoming Webhook URL（必填）
    insecure: false  # 是否跳过SSL验证（可选，默认false）
    proxy: http://my.proxy:3128  # HTTP(S)代理地址（可选）
    ca_certs:  # 信任的CA证书列表（可选）
    - domain: example.com
      cert: |
        -----BEGIN CERTIFICATE-----
        ...
        -----END CERTIFICATE-----

行为（out操作）

通过put步骤发送消息：

必选参数（至少选择一项）

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

可选参数

• channel：接收频道（如#channel或@user，支持多个）
• channel_file：包含频道列表的文件路径
• username：发送者用户名
• icon_url：图标URL
• icon_emoji：图标emoji（如:ghost:）
• silent：是否隐藏curl输出（避免泄露Webhook URL）
• always_notify：即使文本缺失也尝试发送（默认false）

示例：Concourse Job中发送通知

yaml
jobs:
- name: build-and-notify
  plan:
  - task: build-app
    config:
      # 构建任务配置...
  - put: slack-alert
    params:
      channel: '#ci-notifications'
      text: |
        构建结果：成功
        管道名称：$BUILD_PIPELINE_NAME
        构建ID：$BUILD_ID
        详情链接：[***]