plugins/matrix

drone-matrix

镜像概述

drone-matrix是由https://github.com/drone-plugins/drone-matrix%E7%BB%B4%E6%8A%A4%E7%9A%84Drone CI插件，通过Drone CI构建并推送。该镜像作为Drone CI生态的一部分，专门用于在CI/CD流水线执行过程中，将构建状态、结果等信息通过Matrix协议发送到指定的聊天房间，实现团队对构建过程的实时监控与协作。

核心功能与特性

• Matrix协议集成：支持与Matrix协议兼容的聊天平台（如Element）进行通信
• Drone CI无缝对接：作为Drone CI插件，可直接在Drone流水线配置中调用
• 灵活的通知配置：支持自定义通知消息内容、触发条件及目标房间
• 轻量级设计：基于容器化部署，资源占用低，易于集成到现有CI/CD流程

使用场景与适用范围

• CI/CD流水线状态通知：构建成功/失败、测试结果、部署状态等关键节点通知
• 团队协作：开发团队实时获取构建动态，快速响应问题
• 自动化流程监控：对自动化构建、测试、部署流程进行状态跟踪

使用方法与配置说明

环境变量配置

Drone CI配置示例

在Drone CI的.drone.yml配置文件中使用该插件：

yaml
kind: pipeline
type: docker
name: default

steps:
  - name: matrix-notify
    image: plugins/matrix
    settings:
      homeserver: https://matrix.org
      access_token: your_access_token
      room_id: !abcdefghijklmnop:matrix.org
      message: "Build {{ build.status }}: {{ repo.name }}#{{ build.number }} ({{ commit.sha }})"

Docker运行示例

直接通过Docker命令运行（需替换环境变量值）：

bash
docker run --rm \
  -e MATRIX_HOMESERVER=https://matrix.org \
  -e MATRIX_ACCESS_TOKEN=your_access_token \
  -e MATRIX_ROOM_ID=!abcdefghijklmnop:matrix.org \
  -e MATRIX_MESSAGE="Drone build completed successfully" \
  plugins/matrix

相关链接

• 项目源码：https://github.com/drone-plugins/drone-matrix
• Drone CI官方文档：[***]
• Matrix协议文档：[***]