Slack Notifications Service · Gitlab 中文文檔

# Slack Notifications Service > 原文：[https://docs.gitlab.com/ee/user/project/integrations/slack.html](https://docs.gitlab.com/ee/user/project/integrations/slack.html) * [Slack configuration](#slack-configuration) * [GitLab configuration](#gitlab-configuration) * [Triggers available for Slack notifications](#triggers-available-for-slack-notifications) * [Troubleshooting](#troubleshooting) * [Something went wrong on our end](#something-went-wrong-on-our-end) * [`certificate verify failed`](#certificate-verify-failed) # Slack Notifications Service[](#slack-notifications-service "Permalink") Slack Notifications Service 允許您的 GitLab 項目將事件（例如問題創建）作為通知發送到您現有的 Slack 團隊. 設置 Slack 通知需要同時更改 Slack 和 GitLab 的配置. **注意：**您還可以使用 Slack 斜杠命令在 Slack 中控制 GitLab. 這是單獨配置的[Slack 斜杠命令](slack_slash_commands.html) . ## Slack configuration[](#slack-configuration "Permalink") 1. 登錄到 Slack 團隊并[開始新的 Incoming WebHooks 配置](https://my.slack.com/services/new/incoming-webhook) . 2. 選擇默認情況下將通知發送到的松弛通道. 單擊**添加傳入的 WebHooks 集成**按鈕以添加配置. 3. 復制**Webhook URL** ，我們將在以后的 GitLab 配置中使用它. ## GitLab configuration[](#gitlab-configuration "Permalink") 1. Open your project’s page, and navigate to your project’s [Integrations page](overview.html#accessing-integrations) at **設置>集成**. 2. 選擇**Slack Notifications**集成進行配置. 3. Click **啟用整合**. 4. 在**Trigger 中** ，選中每種類型的 GitLab 事件的復選框，以將其發送給 Slack 作為通知. 有關完整列表，請參閱[可用于 Slack 通知的觸發器](#triggers-available-for-slack-notifications) . 默認情況下，消息將發送到您在[Slack 集成](#slack-configuration)期間配置的通道. 5. （可選）要將消息發送到其他渠道，多個渠道或作為直接消息： * 要將消息發送到頻道，請輸入 Slack 頻道名稱，以逗號分隔. * 要發送直接消息，請使用在用戶的 Slack 個人資料中找到的會員 ID.**注意：**不支持用戶名和私人頻道. 6. 在**Webhook 中** ，提供您從[Slack 集成](#slack-configuration)步驟復制的**Webhook** URL. 7. （可選）在**Username 中** ，提供發送通知的 Slack 機器人的用戶名. 8. 選擇**僅通知斷開的管道**復選框以僅通知失敗. 9. 在**要通知**的**分支中**選擇框，選擇要為其發送通知的分支類型. 10. Click **測試設置并保存更改**. 您的 Slack 團隊現在將開始按照配置接收 GitLab 事件通知. ### Triggers available for Slack notifications[](#triggers-available-for-slack-notifications "Permalink") 以下觸發器可用于 Slack 通知： * **推送** ：由推送到存儲庫觸發. * **問題** ：在創建，更新或關閉問題時觸發. * **機密問題** ：創建，更新或關閉機密問題時觸發. * **合并請求** ：在創建，更新或合并合并請求時觸發. * **注意** ：有人添加評論時觸發. * **機密注釋** ：當有人添加機密注釋時觸發. * **標簽推送** ：將新標簽推送到存儲庫時觸發. * **管道** ：管道狀態更改時觸發. * **Wiki 頁面** ：在創建或更新 Wiki 頁面時觸發. * **部署** ：在部署完成時觸發. * **警報** ：記錄新的唯一警報時觸發. ## Troubleshooting[](#troubleshooting "Permalink") 如果您的 Slack 集成無法正常工作，請通過在[Sidekiq 日志中](../../../administration/logs.html#sidekiqlog)搜索與 Slack 服務相關的錯誤來開始故障排除. ### Something went wrong on our end[](#something-went-wrong-on-our-end "Permalink") 這是 GitLab UI 中顯示的一般錯誤，其本身并沒有多大意義. 查看[日志](../../../administration/logs.html#productionlog)以查找錯誤消息，并從那里繼續進行故障排除. ### `certificate verify failed`[](#certificate-verify-failed "Permalink") 您可能會在 Sidekiq 日志中看到類似于以下內容的條目： ``` 2019-01-10_13:22:08.42572 2019-01-10T13:22:08.425Z 6877 TID-abcdefg ProjectServiceWorker JID-3bade5fb3dd47a85db6d78c5 ERROR: {:class=>"ProjectServiceWorker", :service_class=>"SlackService", :message=>"SSL_connect returned=1 errno=0 state=error: certificate verify failed"} ``` GitLab 與 Slack 通信或 GitLab 與自身通信可能是一個問題. 前者的可能性較小，因為 Slack 的安全證書*希望*始終受到信任. 我們可以使用下面的 rails 控制臺腳本來確定要處理的內容. ``` # start a rails console: sudo gitlab-rails console -e production # or for source installs: bundle exec rails console -e production ``` ``` # run this in the Rails console # replace <SLACK URL> with your actual Slack URL result = Net::HTTP.get(URI('https://<SLACK URL>'));0 # replace <GITLAB URL> with your actual GitLab URL result = Net::HTTP.get(URI('https://<GITLAB URL>'));0 ``` 如果 GitLab 不信任自身的 HTTPS 連接，則可能需要[將證書添加到 GitLab 的受信任證書中](https://docs.gitlab.com/omnibus/settings/ssl.html) . 如果 GitLab 不信任與 Slack 的連接，則 GitLab OpenSSL 信任存儲不正確. 一些典型的原因：使用`gitlab_rails['env'] = {"SSL_CERT_FILE" => "/path/to/file.pem"}`覆蓋信任庫，或不小心修改了默認的 CA 捆綁包`/opt/gitlab/embedded/ssl/certs/cacert.pem` .