极狐 GitLab

Mattermost 斜杠命令

Tier: 基础版，专业版，旗舰版

Offering: JihuLab.com，私有化部署

您可以使用 斜杠命令 从 Mattermost 聊天环境运行常见的极狐GitLab 操作，例如创建议题。

极狐GitLab 还可以将事件（如 议题创建）作为单独配置的 Mattermost 通知 的一部分发送到 Mattermost。

有关可用的斜杠命令列表，请参见 斜杠命令。

配置选项#

极狐GitLab 提供了多种配置 Mattermost 斜杠命令的方式。对于所有这些选项，您必须使用 Mattermost 3.4 或更高版本。

自动配置#

如果 Mattermost 与极狐GitLab 安装在同一台服务器上，您可以自动配置 Mattermost 斜杠命令：

  1. 在顶部栏中，选择 搜索或跳转到 并找到您的项目。
  2. 在左侧边栏中，选择 设置 > 集成。
  3. 选择 Mattermost 斜杠命令。
  4. 在 启用集成 下，确保选中 激活 复选框。
  5. 选择 添加到 Mattermost，然后选择 保存更改。

手动配置#

要手动配置 Mattermost 中的斜杠命令，您必须：

  1. 在 Mattermost 中启用自定义斜杠命令。此步骤仅对自行编译的安装是必需的。
  2. 从极狐GitLab 获取配置值。
  3. 在 Mattermost 中创建斜杠命令。
  4. 将 Mattermost 令牌提供给极狐GitLab。

在 Mattermost 中启用自定义斜杠命令#

要从 Mattermost 管理员控制台启用自定义斜杠命令：

  1. 使用具有管理员权限的用户登录 Mattermost。
  2. 在您的用户名旁边，选择 设置 图标，然后选择 系统控制台。
  3. 选择 集成管理，并将以下值设置为 TRUE：
    • 启用自定义斜杠命令
    • 启用集成以覆盖用户名
    • 启用集成以覆盖个人资料图片图标
  4. 选择 保存，但不要关闭此浏览器选项卡。您将在后面的步骤中需要它。

从极狐GitLab 获取配置值#

要从极狐GitLab 获取配置值：

  1. 在另一个浏览器选项卡中，使用具有管理员访问权限的用户登录极狐GitLab。
  2. 在右上角，选择 管理员。
  3. 在左侧边栏中，选择 设置 > 集成。
  4. 选择 Mattermost 斜杠命令。极狐GitLab 会显示 Mattermost 设置的潜在值。
  5. 复制 请求 URL 值。所有其他值均为建议值。
  6. 不要关闭此浏览器选项卡。您将在后面的步骤中需要它。

在 Mattermost 中创建斜杠命令#

要在 Mattermost 中创建斜杠命令：

  1. 在 Mattermost 浏览器选项卡中，转到您的团队页面。

  2. 选择

    设置 图标，然后选择 集成。

  3. 在左侧边栏中，选择 斜杠命令。

  4. 选择 添加斜杠命令。

  5. 为您的命令提供 显示名称 和 描述。

  6. 根据您的应用程序配置提供 命令触发词：

    • 如果您只想将一个项目连接到您的 Mattermost 团队，请使用 /gitlab 作为触发词。
    • 如果您打算连接多个项目，请使用与您的项目相关的触发词，例如 /project-name 或 /gitlab-project-name。

  7. 对于 请求 URL，粘贴您从极狐GitLab 复制的值。

  8. 对于所有其他值，您可以使用极狐GitLab 的建议或您偏好的值。

  9. 复制 令牌 值，然后选择 完成。

将 Mattermost 令牌提供给极狐GitLab#

在 Mattermost 中创建斜杠命令会生成一个令牌，您必须将其提供给极狐GitLab：

  1. 在 极狐GitLab 浏览器选项卡中，选中 激活 复选框。
  2. 在 令牌 文本框中，粘贴您从 Mattermost 复制的令牌。
  3. 选择 保存更改。

您的斜杠命令现在可以与您的极狐GitLab 项目通信。

将您的极狐GitLab 帐户连接到 Mattermost#

先决条件：

  • 要运行 斜杠命令，您必须拥有在极狐GitLab 项目中执行该操作的 权限。

要使用 Mattermost 斜杠命令与极狐GitLab 进行交互：

  1. 在 Mattermost 聊天环境中，运行您的新斜杠命令。
  2. 选择 连接您的极狐GitLab 帐户 以授权访问。

您可以在 Mattermost 个人资料页面中的 聊天 下查看所有已授权的聊天帐户。

故障排查#

当 Mattermost 斜杠命令未触发极狐GitLab 中的事件时：

  • 确保您使用的是公共频道。Mattermost webhooks 无法访问私有频道。
  • 如果您需要私有频道，请编辑 webhook 频道，并选择一个私有频道。所有事件都将发送到指定的频道。