Mattermost slash commands · Gitlab 中文文檔

# Mattermost slash commands > 原文：[https://docs.gitlab.com/ee/user/project/integrations/mattermost_slash_commands.html](https://docs.gitlab.com/ee/user/project/integrations/mattermost_slash_commands.html) * [Prerequisites](#prerequisites) * [Automated configuration](#automated-configuration) * [Manual configuration](#manual-configuration) * [Step 1\. Enable custom slash commands in Mattermost](#step-1-enable-custom-slash-commands-in-mattermost) * [Step 2\. Open the Mattermost slash commands service in GitLab](#step-2-open-the-mattermost-slash-commands-service-in-gitlab) * [Step 3\. Create a new custom slash command in Mattermost](#step-3-create-a-new-custom-slash-command-in-mattermost) * [Step 4\. Copy the Mattermost token into the Mattermost slash command service](#step-4-copy-the-mattermost-token-into-the-mattermost-slash-command-service) * [Authorizing Mattermost to interact with GitLab](#authorizing-mattermost-to-interact-with-gitlab) * [Available slash commands](#available-slash-commands) * [Permissions](#permissions) * [Troubleshooting](#troubleshooting) * [Further reading](#further-reading) # Mattermost slash commands[](#mattermost-slash-commands "Permalink") 在 GitLab 8.14 中引入 Mattermost 命令為用戶提供了一個額外的界面，可以在聊天環境中執行常見操作. 例如，這使得一個問題一經在 Mattermost 中討論后就可以創建. GitLab 還可以將事件（例如， `issue created` ）作為通知發送到 Mattermost. 這是單獨配置的[Mattermost Notifications Service](mattermost.html) . ## Prerequisites[](#prerequisites "Permalink") 需要 Mattermost 3.4 及更高版本. 如果您安裝了 Omnibus GitLab 軟件包，則其中已包含 Mattermost. 您所要做的就是配置它. 在[Omnibus GitLab Mattermost 文檔中](https://docs.gitlab.com/omnibus/gitlab-mattermost/)閱讀更多[內容](https://docs.gitlab.com/omnibus/gitlab-mattermost/) . ## Automated configuration[](#automated-configuration "Permalink") 如果 Mattermost 與 GitLab 安裝在同一服務器上，則 GitLab 可以為您完成配置過程. 轉到項目上的 Mattermost Slash Command 服務，然后單擊"添加到 Mattermost"按鈕. ## Manual configuration[](#manual-configuration "Permalink") 配置由兩部分組成. 首先，您需要在 Mattermost 中啟用斜杠命令，然后在 GitLab 中啟用該服務. ### Step 1\. Enable custom slash commands in Mattermost[](#step-1-enable-custom-slash-commands-in-mattermost "Permalink") 僅在使用源代碼安裝時才需要執行此步驟，Omnibus 安裝將使用正確的設置進行預配置. 在 Mattermost 中要做的第一件事是從管理員控制臺啟用自定義斜杠命令. 1. 使用具有管理員權限的帳戶登錄并導航至系統控制臺. [![Mattermost go to console](https://img.kancloud.cn/cb/d6/cbd6386657af7bc0de5368bed743ca61_221x498.png)](img/mattermost_goto_console.png) 2. 單擊" **自定義集成"**并將" **啟用自定義斜杠命令"** ，" **啟用自定義集成以覆蓋用戶名** "和" **覆蓋自定義集成以覆蓋個人資料圖片圖標"設置**為 true. [![Mattermost console](https://img.kancloud.cn/80/2c/802c665114947d99723d07820433cbb4_1662x1266.png)](img/mattermost_console_integrations.png) 3. 點擊底部的**保存** ，保存更改. ### Step 2\. Open the Mattermost slash commands service in GitLab[](#step-2-open-the-mattermost-slash-commands-service-in-gitlab "Permalink") 1. 打開 GitLab 的新標簽，轉到項目的" [集成"頁面，](overview.html#accessing-integrations)然后選擇**Mattermost 命令**服務進行配置. 將出現一個屏幕，其中包含您需要在 Mattermost 中復制的所有值，如下一步所述. 使窗口保持打開狀態. **注意：** GitLab 將為"最重要的設置"建議一些值. 原樣復制粘貼的唯一要求是**請求 URL** ，所有其他都只是建議. [![Mattermost setup instructions](https://img.kancloud.cn/27/e5/27e503820e905cdb6142f61c542c4cd8_1884x1940.png)](img/mattermost_config_help.png) 2. 繼續下一步，并在 Mattermost 中使用上述值創建斜線命令. ### Step 3\. Create a new custom slash command in Mattermost[](#step-3-create-a-new-custom-slash-command-in-mattermost "Permalink") 現在，您已在 Mattermost 中啟用了自定義斜杠命令并在 GitLab 中打開了 Mattermost 斜杠命令服務，是時候將這些值復制到新的斜杠命令中了. 1. 回到 Mattermost，在團隊頁面設置下，您應該看到**Integrations**選項. [![Mattermost team integrations](https://img.kancloud.cn/35/ed/35ed2c92eb49e1b65531e742a8b3d291_216x249.png)](img/mattermost_team_integrations.png) 2. 轉到**Slash Commands**集成，然后單擊**Add Slash Command**按鈕添加一個新的. [![Mattermost add command](https://img.kancloud.cn/29/50/2950fc11c14bab5160979669b5bd8088_974x327.png)](img/mattermost_add_slash_command.png) 3. 按照[步驟 2 中的說明](#step-2-open-the-mattermost-slash-commands-service-in-gitlab)填寫自定義命令的選項. **注意：**如果計劃連接多個項目，請選擇一個與項目相關的斜杠命令觸發詞，例如`/gitlab-project-name`或什至`/project-name` . 僅在將單個項目連接到 Mattermost 團隊時才使用`/gitlab` . [![Mattermost add command configuration](https://img.kancloud.cn/c4/87/c4873e06d31cc831cd119c5e986ed6cf_625x912.png)](img/mattermost_slash_command_configuration.png) 4. 設置所有值之后，復制令牌（我們將在下面使用它）并單擊**完成** . [![Mattermost slash command token](https://img.kancloud.cn/ea/d0/ead0df98b08cfbf254a5f6abcd9ca15b_1080x333.png)](img/mattermost_slash_command_token.png) ### Step 4\. Copy the Mattermost token into the Mattermost slash command service[](#step-4-copy-the-mattermost-token-into-the-mattermost-slash-command-service "Permalink") 1. 在 GitLab 中，粘貼您在上一步中復制的最重要的令牌，并確保啟用了**活動**切換. [![Mattermost copy token to GitLab](https://img.kancloud.cn/a6/c9/a6c9eca582ca2f3cc6f1a57000179cec_404x157.png)](img/mattermost_gitlab_token.png) 2. 單擊**保存更改**以使更改生效. 現在，您已設置為在 Mattermost 中開始使用與您配置的 GitLab 項目對話的斜杠命令. ## Authorizing Mattermost to interact with GitLab[](#authorizing-mattermost-to-interact-with-gitlab "Permalink") 用戶首次與新創建的斜杠命令進行交互時，Mattermost 將觸發授權過程. [![Mattermost bot authorize](https://img.kancloud.cn/77/01/7701a97da8271fd1a8c9516d89bea0a9_578x69.png)](img/mattermost_bot_auth.png) 這會將您的 Mattermost 用戶與 GitLab 用戶連接起來. 您可以在個人資料頁面的" **聊天"**下看到所有授權的聊天帳戶. 授權過程完成后，您可以使用 Mattermost 命令開始與 GitLab 進行交互. ## Available slash commands[](#available-slash-commands "Permalink") 可用的斜杠命令是： | Command | Description | Example | | --- | --- | --- | | `/ <trigger>發出新的<title> `?Shift` + `?輸入` <description>` | 在與`<trigger>`綁定的項目中創建一個新問題. `<description>`是可選的. | `/gitlab issue new We need to change the homepage` | | `/<trigger> issue show <issue-number>` | 顯示與`<trigger>`綁定的項目中 ID 為`<issue-number>` . | `/gitlab issue show 42` | | `/ <觸發>將<環境>部署到<環境>` | 開始從一個環境部署到另一環境的 CI 作業，例如`staging`到`production` . CI / CD 必須[正確配置](../../../ci/yaml/README.html) . | `/gitlab deploy staging to production` | 要查看與 GitLab 交互的可用命令列表，請輸入觸發詞，然后輸入`help` . 示例： `/gitlab help` [![Mattermost bot available commands](https://img.kancloud.cn/0a/06/0a06644ae9888449ce158337f71781d6_491x145.png)](img/mattermost_bot_available_commands.png) ## Permissions[](#permissions "Permalink") 運行[可用命令](#available-slash-commands)的[權限](../../permissions.html#project-members-permissions)源自[您對項目](../../permissions.html#project-members-permissions)的[權限](../../permissions.html#project-members-permissions) . ## Troubleshooting[](#troubleshooting "Permalink") 如果未觸發某個事件，請確認您使用的頻道是公開頻道，因為 Mattermost Webhooks 無法訪問私有頻道. 如果需要專用頻道，則可以在 Mattermost 中編輯 Webhook 的頻道并選擇一個專用頻道. 無法將不同的通道用于不同類型的通知-所有事件都將發送到指定的通道. ## Further reading[](#further-reading "Permalink") * [Mattermost slash commands documentation](https://docs.mattermost.com/developer/slash-commands.html) * [Omnibus GitLab Mattermost](https://docs.gitlab.com/omnibus/gitlab-mattermost/)