分享方式:


與服務勾點整合

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

當 Azure DevOps 中的項目發生事件時,Service Hooks 可讓您在其他服務上執行工作。

例如,當工作專案建立時,您可以在 Trello 中建立卡片,或在組建失敗時將推播通知傳送給小組的行動裝置。 您也可以在自定義應用程式和服務中使用服務勾點,以更有效率的方式在專案中發生事件時驅動活動。

服務勾點的運作方式為何?

服務攔截 發行者會 定義一組 您可以訂閱的事件 用帳戶會接聽這些 事件 ,並定義 要根據事件採取的動作

訂用帳戶也會以取用者為目標,這些是外部服務,可在事件發生時執行自己的動作。

服務勾點的圖表。

注意

服務勾點需要允許IP範圍來連入服務端點。 服務端點是提供給服務勾點的屬性集。 如需詳細資訊,請參閱 允許的位址清單和網路連線、IP 位址和範圍限制

可用的服務

下列服務可作為服務攔截的目標。 如需其他與 Azure DevOps 整合之應用程式和服務的詳細資訊,請移至 Visual Studio Marketplace

服務 支援的事件 支援的動作
App Center 工作專案已更新 傳送通知。 訂用帳戶是透過App Center管理。
AppVeyor 推送的程序代碼 觸發 AppVeyor 組建。 訂用帳戶是透過AppVeyor管理。
Azuqua 全部 將事件張貼至 FLO。 訂用帳戶是透過 Azuqua 管理。
Azure App Service 推送的程序代碼 部署 Web 應用程式。 訂用帳戶是透過 Azure App 服務 來管理。
Azure 服務匯流排 全部 將訊息傳送至通知中樞、服務匯流排 佇列或 服務匯流排 主題。 訂用帳戶是透過 Azure App 服務 來管理。
Azure 儲存體 全部 在記憶體佇列中插入訊息。
建置已完成,程式代碼已推送 將組建排入佇列。
Datadog 全部 在 Datadog 中張貼事件。
Grafana 發行部署已完成 將註釋新增至 Grafana 資料庫。
Jenkins 建置已完成,程式代碼推送,PR 合併嘗試,發行部署已完成 觸發泛型或 Git 組建。
Microsoft Teams 全部 將訊息張貼至通道。 訂用帳戶是在 Microsoft Teams 中管理。
MyGet 建置已完成,程式代碼已推送 將 NuGet 套件發佈至 MyGet。 觸發 MyGet 組建。 訂用帳戶是由 MyGet 管理。
Office 365 全部 將訊息張貼至群組。
Slack 全部 將訊息張貼至通道。
Trello 全部 建立卡片或清單。
UserVoice 已建立工作專案,工作專案已更新 傳送連結的工作專案事件。 訂用帳戶是透過UserVoice來管理。
Web 勾點 全部 透過 HTTP 張貼。
工作場所訊息應用程式 全部 傳送通知。 訂用帳戶是透過工作場所訊息應用程式進行管理。
Zapier 全部 傳送通知。 訂用帳戶是透過 Zapier 管理。
Zendesk 已批注的工作專案 在票證中建立私人批注。
服務 支援的事件 支援的動作
Azure 服務匯流排 全部 將訊息傳送至通知中樞、服務匯流排 佇列或 服務匯流排 主題。 訂用帳戶是透過 Azure App 服務 來管理。
Azure 儲存體 全部 在記憶體佇列中插入訊息。
建置已完成,程式代碼已推送 將組建排入佇列。
Datadog 全部 在 Datadog 中張貼事件。
Grafana 發行部署已完成 將註釋新增至 Grafana 資料庫。
Jenkins 建置已完成,程式代碼推送,PR 合併嘗試,發行部署已完成 觸發泛型或 Git 組建。
Microsoft Teams 全部 將訊息張貼至通道。 訂用帳戶是在 Microsoft Teams 中管理。
Office 365 全部 將訊息張貼至群組。
Slack 全部 將訊息張貼至通道。
Trello 全部 建立卡片或清單。
[UserVoice]((https://www.uservoice.com 已建立工作專案,工作專案已更新 傳送連結的工作專案事件。 訂用帳戶是透過UserVoice來管理。
Web 勾點 全部 透過 HTTP 張貼。
Zendesk 已批注的工作專案 在票證中建立私人批注。

建立訂用帳戶

在整合其中一項服務與 Azure DevOps 時,您必須建立新的訂用帳戶。 在許多情況下,您也需要在其他服務中執行一些設定。 如需特定詳細數據,請查看您感興趣的服務資訊。

  1. 在 Web 存取中開啟專案的管理員頁面。

    醒目提示 [項目設定] 按鈕的螢幕快照。
  2. 執行精靈以建立訂用帳戶。

    醒目提示按鈕 [建立訂用帳戶] 的螢幕快照。

  3. 選取您想要與整合的服務。

    選取要整合的服務

  4. 選取要觸發的事件,以及任何適用的篩選。

    選取要觸發的事件,以及任何篩選

  5. 選取在目標服務上執行的動作。

    注意

    可用的動作清單可能會根據您選取的事件類型來限制。

    顯示目標服務動作選取專案的螢幕快照。

  6. 若要確認設定正確,請測試訂用帳戶,然後完成精靈。

    顯示測試通知 1 的螢幕快照。

    顯示測試通知 2 的螢幕快照。

常見問題集

問:我需要哪些許可權才能設定訂用帳戶?

答: 編輯訂用帳戶檢視訂閱。 根據預設,只有專案系統管理員具有這些權限。 若要向其他使用者直接授與這些權限,您可以使用命令列工具安全性 REST API。

若要授與群組的檢視許可權,請參閱在服務勾點頁面中設定群組的檢視許可權。

問:授與編輯訂閱和檢視訂閱許可權的安全性影響為何?

答:具有這些許可權的使用者可以看到專案中建立的所有訂用帳戶,以及這些訂用帳戶的通知歷程記錄。 然後,該使用者可以在該專案中建立任何類型的服務攔截訂用帳戶。 如果用戶為沒有許可權的資源設定訂用帳戶,則不會觸發訂用帳戶。

例如: 如果您無法存取這些工作專案,您在區域路徑 XYZ 中建立工作專案更新事件的訂用帳戶將不會傳送通知。 不過,您可以看到可存取這些工作專案的其他使用者的通知歷程記錄。

問:我可以以程序設計方式建立專案的服務勾點訂閱嗎?

A: 可以。 如需詳細資訊,請參閱 建立服務勾點訂用帳戶

問:我是否可以在授權組織之後移除應用程式的存取權?

A: 可以。 您可以從設定檔撤銷授權。

  1. https://visualstudio.microsoft.com/移至您的設定檔頁面。

    請確定您從 Visual Studio 網站 (https://visualstudio.microsoft.com/) 而不是組織 (https://dev.azure.com/{orgName}) 開始,因為從組織存取的設定檔會帶您執行錯誤的授權管理功能。

  2. 管理您的授權。

    顯示醒目提示 [管理應用程式] 按鈕的螢幕快照。

  3. 撤銷您不想再允許的任何授權。

    顯示授權撤銷選項的螢幕快照。

問:為什麼我們不能再為 HipChat 設定服務勾點?

答:Atlassian 正式放棄對 HipChat 的支援。 如需詳細資訊,請參閱公告