ionphractal/matrix-notification-resource

Matrix Notification Resource 镜像说明

镜像概述

本镜像作为Concourse CI的第三方资源类型，实现了与Matrix即时通讯服务器的集成，支持在CI/CD流水线中触发通知消息推送，帮助团队实时掌握流水线运行状态。

核心功能

1. 向指定Matrix房间发送自定义文本通知
2. 无缝对接Concourse CI的资源接口，可在流水线各阶段（构建、部署、测试等）触发通知
3. 支持配置Matrix服务器地址、用户访问令牌、目标房间ID等关键参数

使用场景

• CI流水线结果通知：构建成功/失败、测试通过/不通过时推送状态到团队Matrix房间
• 部署任务通知：应用部署完成或异常时通知相关人员
• 关键任务状态推送：如数据同步、报表生成等任务完成后发送通知

配置说明

使用该资源需提供以下参数：

• homeserver：Matrix服务器地址（例如 https://matrix.example.com）
• access_token：Matrix用户的身份验证令牌
• room_id：目标Matrix房间的唯一ID（例如 !abc123:example.com）
• message：需要发送的通知内容

部署示例（Concourse Pipeline配置）

在Concourse流水线配置文件中添加资源定义及任务使用示例：

yaml
# 资源定义
resources:
- name: matrix-notification
  type: docker-image
  source:
    repository: ionphractal/matrix-notification-resource
    tag: latest

# 任务示例
jobs:
- name: send-build-notification
  plan:
  - task: build-application
    config:
      platform: linux
      image_resource:
        type: docker-image
        source: {repository: node, tag: 20}
      run:
        path: npm
        args: ["run", "build"]
  - put: matrix-notification
    params:
      message: "应用构建任务已完成"
      homeserver: "[***]"
      access_token: ((matrix_access_token)) # 建议使用Concourse变量管理
      room_id: "!your_room_id:yourdomain.com"