正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

Mattermost通知

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

Mattermost通知インテグレーションを使用して、GitLabイベント(issue createdなど)の通知をMattermostに送信します。MattermostGitLabの両方を設定する必要があります。

Mattermostスラッシュコマンドを使用して、Mattermost内でGitLabを制御することもできます。

GitLabの通知を受信するようにMattermostを設定します

Mattermostインテグレーションを使用するには、Mattermostで受信Webhookインテグレーションを作成する必要があります:

  1. Mattermostインスタンスにサインインします。
  2. 着信Webhookを有効にする
  3. 着信Webhookを追加
  4. 表示名、説明、チャンネルを選択します。これらはGitLabでオーバーライドできます。
  5. 保存してWebhookのURLをコピーします。これは後でGitLabで必要になるためです。

受信Webhookは、Mattermostインスタンスでブロックされている可能性があります。Mattermost管理者に、以下で有効にするように依頼してください:

  • Mattermost System Console(Mattermostシステムコンソール) > インテグレーション > Mattermostバージョン5.12以降のIntegration Management
  • Mattermost System Console(Mattermostシステムコンソール) > インテグレーション > Mattermostバージョン5.11以前のCustom Integrations(カスタムインテグレーション)。

表示名のオーバーライドはデフォルトで有効になっていません。Mattermost管理者に、同じセクションで有効にするように依頼する必要があります。

Mattermostに通知を送信するようにGitLabを設定します

Mattermostインスタンスに受信Webhookがセットアップされたら、通知を送信するようにGitLabをセットアップできます:

  1. 左側のサイドバーで、検索または移動先を選択して、プロジェクトを見つけます。

  2. 設定 > インテグレーションを選択します。

  3. Mattermost通知を選択します。

  4. 通知を生成するGitLabイベントを選択します。選択したイベントごとに、通知を受信するMattermostチャンネルを入力します。ハッシュ記号(#)を追加する必要はありません。

  5. インテグレーションの設定に入力します:

    • Webhook: Mattermostの受信WebhookのURL。http://mattermost.example/hooks/5xo…に類似しています。
    • ユーザー名: オプション。Mattermostに送信されるメッセージに表示されるユーザー名。ボットのユーザー名を変更するには、値を入力します。
    • 壊れたパイプラインのみ通知: パイプラインイベントを有効にして、失敗したパイプラインに関する通知のみが必要な場合。
    • 通知を送信するブランチ: 通知を送信するブランチ。
    • Labels to be notified(通知されるラベル): オプション。通知をトリガーするためにイシューまたはマージリクエストに必要なラベル。すべてのイシューとマージリクエストの通知をトリガーするには、空白のままにします。
    • Labels to be notified behavior(通知されるラベルの動作): Labels to be notified(通知されるラベル)フィルターを使用すると、イシューまたはマージリクエストにフィルターで指定されたラベルのいずれかが含まれている場合に、メッセージが送信されます。イシューまたはマージリクエストにフィルターで定義されたすべてのラベルが含まれている場合にのみメッセージをトリガーするように選択することもできます。