Help us learn about your current experience with the documentation. Take the survey.

Mattermost 通知

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

使用 Mattermost 通知集成将 GitLab 事件(例如 issue created)的通知发送到 Mattermost。您必须同时配置 MattermostGitLab

您还可以使用 Mattermost 斜杠命令 在 Mattermost 中控制 GitLab。

配置 Mattermost 以接收 GitLab 通知

要使用 Mattermost 集成,您必须在 Mattermost 中创建一个入站 webhook 集成:

  1. 登录到您的 Mattermost 实例。
  2. 启用入站 webhook
  3. 添加入站 webhook
  4. 选择显示名称、描述和频道,这些都可以在 GitLab 中覆盖。
  5. 保存并复制 Webhook URL,因为稍后我们需要在 GitLab 中使用它。

入站 Webhook 可能会被您的 Mattermost 实例阻止。请询问您的 Mattermost 管理员在以下位置启用它:

  • 在 Mattermost 5.12 及更高版本中:Mattermost 系统控制台 > 集成 > 集成管理
  • 在 Mattermost 5.11 及更早版本中:Mattermost 系统控制台 > 集成 > 自定义集成

显示名称覆盖默认未启用,您需要要求管理员在同一部分启用它。

配置 GitLab 以发送通知到 Mattermost

在 Mattermost 实例设置了入站 webhook 后,您可以设置 GitLab 来发送通知:

  1. 在左侧边栏,选择 搜索或跳转至 并找到您的项目。

  2. 选择 设置 > 集成

  3. 选择 Mattermost 通知

  4. 选择要生成通知的 GitLab 事件。对于您选择的每个事件,输入接收通知的 Mattermost 频道。您不需要添加井号(#)。

  5. 填写集成配置:

    • Webhook:Mattermost 上的入站 webhook URL,类似于 http://mattermost.example/hooks/5xo…
    • Username:可选。发送到 Mattermost 的消息中显示的用户名。要更改机器人的用户名,请提供一个值。
    • 仅通知失败的管道:如果您启用了 Pipeline 事件,并且只想接收有关失败管道的通知。
    • 发送通知的分支:要发送通知的分支。
    • 要通知的标签:可选。触发通知所需的标签。留空则通知所有问题和合并请求。
    • 要通知的标签行为:当您使用 要通知的标签 过滤器时,当问题或合并请求包含过滤器中指定的任何标签时,会发送消息。您也可以选择仅在问题或合并请求包含过滤器中定义的所有标签时触发消息。