madrisan/mattermost-notify

镜像概述与主要用途

Mattermost Notify（go-mattermost-notify）是一个用Go编写的简单开源客户端，可通过Mattermost的REST API v4向其发送消息。该工具使用Go的http和url库与Mattermost服务器交互，并结合Cobra（命令行框架）和https://github.com/spf13/viper%EF%BC%88%E9%85%8D%E7%BD%AE%E7%AE%A1%E7%90%86%E5%BA%93%EF%BC%89%E5%AE%9E%E7%8E%B0%E5%91%BD%E4%BB%A4%E8%A1%8C%E7%95%8C%E9%9D%A2%E3%80%82

维护者：https://github.com/madrisan
官方项目网站：https://github.com/madrisan/go-mattermost-notify/

支持的标签及对应Dockerfile链接

• https://github.com/madrisan/go-mattermost-notify/blob/v1.3.2/deploy/Containerfile https://github.com/madrisan/go-mattermost-notify/blob/v1.3.0/deploy/Containerfile
• https://github.com/madrisan/go-mattermost-notify/blob/v1.3.1/deploy/Containerfile
• https://github.com/madrisan/go-mattermost-notify/blob/v1.3.0/deploy/Containerfile
• https://github.com/madrisan/go-mattermost-notify/blob/v1.2.1/deploy/Containerfile
• https://github.com/madrisan/go-mattermost-notify/blob/v1.2.0/deploy/Containerfile
• https://github.com/madrisan/go-mattermost-notify/blob/v1.1.1/deploy/Containerfile

核心功能与特性

• 基于Go语言开发，轻量高效，支持Mattermost REST API v4
• 提供命令行界面，可自定义消息作者、频道、级别、标题和内容
• 支持团队指定，适配Mattermost的团队结构
• 可选SSL证书配置，兼容内部CA签名的证书环境
• 可集成到自动化流程（如CI/CD、监控告警）中发送通知

使用场景与适用范围

适用于需要通过命令行或容器化部署向Mattermost（或Slack）频道发送通知的场景，尤其适合Kubernetes环境中的任务状态报告、告警通知等自动化需求。

使用方法与配置说明

Mattermost消息示例

更多详情请参见官方GitHub网站：https://github.com/madrisan/go-mattermost-notify

在Kubernetes中使用

可按以下配置定义容器，实现通知发送：

yaml
spec:
  template:
    spec:
      containers:
      - name: mattermost-notify
        image: docker.io/madrisan/mattermost-notify:latest
        imagePullPolicy: "IfNotPresent"
        command:
        - go-mattermost-notify
        - post
        args:
        - --author
        - "CI/CD机器人"  # 消息作者
        - --channel
        - "@deployments"  # 目标频道
        - --level
        - "success"       # 消息级别（如success/error）
        - --message
        - "这是一条由`go-mattermost-notify`发送的测试消息 :tada:\nGitHub项目页面: [madrisan/go-mattermost-notify](https://github.com/madrisan/go-mattermost-notify)"  # 消息内容（支持Markdown）
        - --team
        - "devops"        # 目标团队
        - --title
        - "任务状态"      # 消息标题
        env:
        - name: MATTERMOST_ACCESS_TOKEN  # Mattermost访问令牌（必填）
          valueFrom:
            secretKeyRef:
              name: mattermost-secret
              key: mattermost-access-token
        - name: MATTERMOST_URL           # Mattermost服务器URL（必填）
          value: 'https://mattermost.example.com'
        - name: SSL_CERT_FILE            # SSL证书文件路径（可选，内部CA场景使用）
          value: "/var/run/secrets/ca.crt"

环境变量说明：

• MATTERMOST_ACCESS_TOKEN：Mattermost用户访问令牌，用于API认证，建议通过Secret管理
• MATTERMOST_URL：Mattermost服务器的基础URL（如https://mattermost.example.com）
• SSL_CERT_FILE：SSL根证书文件路径，当服务器使用内部CA签名证书时需配置

许可证

源代码和Dockerfile基于https://github.com/madrisan/go-mattermost-notify/blob/main/LICENSE%E8%AE%B8%E5%8F%AF%E3%80%82