Integrera med tjänstkrokar
Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019
Med Service Hooks kan du köra uppgifter på andra tjänster när händelser inträffar i ditt projekt i Azure DevOps.
Du kan till exempel skapa ett kort i Trello när ett arbetsobjekt skapas eller skicka ett push-meddelande till teamets mobila enheter när ett bygge misslyckas. Du kan också använda tjänstkrokar i anpassade appar och tjänster som ett effektivare sätt att driva aktiviteter när händelser inträffar i dina projekt.
Hur fungerar tjänstkrokar?
Service Hook-utgivare definierar en uppsättning händelser som du kan prenumerera på. Prenumerationer lyssnar efter dessa händelser och definierar åtgärder som ska utföras baserat på händelsen.
Prenumerationer riktar sig också till konsumenter, som är externa tjänster som kan köra sina egna åtgärder när händelser inträffar.
Kommentar
Tjänstkrokar kräver att IP-intervall tillåts för inkommande anslutning till tjänstslutpunkter. Tjänstslutpunkten är den uppsättning egenskaper som tillhandahålls till en tjänstkrok. Mer information finns i Tillåtna adresslistor och nätverksanslutningar, IP-adresser och intervallbegränsningar.
Tillgängliga tjänster
Följande tjänster är tillgängliga som mål för tjänstkrokar. Mer information om andra appar och tjänster som integreras med Azure DevOps finns på Visual Studio Marketplace.
| Tjänst | Händelser som stöds | Åtgärder som stöds |
|---|---|---|
| App Center | Arbetsobjektet har uppdaterats | Skicka meddelande. Prenumerationer hanteras via App Center. |
| AppVeyor | Kod push-överförd | Utlösa en AppVeyor-version. Prenumerationer hanteras via AppVeyor. |
| Azuqua | Alla | Publicera händelsen till FLO. Prenumerationer hanteras via Azuqua. |
| Azure App Service | Kod push-överförd | Distribuera webbapp. Prenumerationer hanteras via Azure App Service. |
| Azure Service Bus | Alla | Skicka ett meddelande till en meddelandehubb, Service Bus-kö eller Service Bus-ämne. Prenumerationen hanteras via Azure App Service. |
| Azure Storage | Alla | Infoga ett meddelande i en lagringskö. |
| Bambu | Bygget har slutförts, koden har push-överförts | Köa ett bygge. |
| Datadog | Alla | Publicera en händelse i Datadog. |
| Grafana | Versionsdistributionen har slutförts | Lägg till anteckningar i Grafana-databasen. |
| Jenkins | Build completed, code pushed, PR merge attempted, release deployment completed | Utlösa allmän version eller Git-version. |
| Microsoft Teams | Alla | Publicera ett meddelande till en kanal. Prenumerationer hanteras i Microsoft Teams. |
| MyGet | Bygget har slutförts, koden har push-överförts | Publicera NuGet-paketet till MyGet. Utlös en MyGet-version. Prenumerationer hanteras av MyGet. |
| Office 365 | Alla | Publicera ett meddelande till en grupp. |
| Slack | Alla | Publicera ett meddelande till en kanal. |
| Trello | Alla | Skapa ett kort eller en lista. |
| UserVoice | Arbetsobjektet har skapats, arbetsobjektet har uppdaterats | Skicka en länkad händelse för arbetsobjekt. Prenumerationer hanteras via UserVoice. |
| Webbkrokar | Alla | Publicera via HTTP. |
| Meddelandeappar för arbetsplats | Alla | Skicka meddelanden. Prenumerationer hanteras via Workplace Message Apps. |
| Zapier | Alla | Skicka meddelande. Prenumerationer hanteras via Zapier. |
| Zendesk | Arbetsobjekt som kommenterats | Skapa en privat kommentar i ett ärende. |
| Tjänst | Händelser som stöds | Åtgärder som stöds |
|---|---|---|
| Azure Service Bus | Alla | Skicka ett meddelande till en meddelandehubb, Service Bus-kö eller Service Bus-ämne. Prenumerationen hanteras via Azure App Service. |
| Azure Storage | Alla | Infoga ett meddelande i en lagringskö. |
| Bambu | Bygget har slutförts, koden har push-överförts | Köa ett bygge. |
| Datadog | Alla | Publicera en händelse i Datadog. |
| Grafana | Versionsdistributionen har slutförts | Lägg till anteckningar i Grafana-databasen. |
| Jenkins | Build completed, code pushed, PR merge attempted, release deployment completed | Utlösa allmän version eller Git-version. |
| Microsoft Teams | Alla | Publicera ett meddelande till en kanal. Prenumerationer hanteras i Microsoft Teams. |
| Office 365 | Alla | Publicera ett meddelande till en grupp. |
| Slack | Alla | Publicera ett meddelande till en kanal. |
| Trello | Alla | Skapa ett kort eller en lista. |
| [UserVoice] ((https://www.uservoice.com) | Arbetsobjektet har skapats, arbetsobjektet har uppdaterats | Skicka en länkad händelse för arbetsobjekt. Prenumerationer hanteras via UserVoice. |
| Webbkrokar | Alla | Publicera via HTTP. |
| Zendesk | Arbetsobjekt som kommenterats | Skapa en privat kommentar i ett ärende. |
Skapa en prenumeration
När du integrerar en av dessa tjänster med Azure DevOps måste du skapa en ny prenumeration. I många fall måste du också göra vissa konfigurationer i den andra tjänsten. Mer information finns i informationen för tjänsten som du är intresserad av.
Öppna administratörssidan för ett projekt i webbåtkomst.
Kör guiden för att skapa prenumerationen.
Välj den tjänst som du vill integrera med.
Välj den händelse som ska utlösas och eventuella tillämpliga filter.
Välj en åtgärd som ska köras på måltjänsten.
Kommentar
Listan över tillgängliga åtgärder kan begränsas baserat på den händelsetyp som du har valt.
Kontrollera att inställningarna är korrekta genom att testa prenumerationen och sedan slutföra guiden.
Vanliga frågor och svar
F: Vilka behörigheter behöver jag för att konfigurera en prenumeration?
S: Redigera prenumerationer och Visa prenumerationer. Som standard har endast projektadministratörer dessa behörigheter. Om du vill bevilja dem till andra användare direkt kan du använda kommandoradsverktyget eller säkerhets-REST-API:et.
Information om hur du beviljar visningsbehörighet för en grupp finns i Ange vybehörighet för en grupp på sidan Service Hooks .
F: Vilka är säkerhetskonsekvenserna av att bevilja behörigheter för Redigera prenumerationer och Visa prenumerationer ?
S: Användaren med dessa behörigheter kan se alla prenumerationer som skapats i projektet och meddelandehistoriken för dessa prenumerationer. Användaren kan sedan skapa valfri typ av tjänsthookprenumeration i projektet. Om användaren konfigurerar en prenumeration för en resurs som de annars inte har behörighet att komma åt utlöses inte prenumerationen.
Till exempel: Prenumerationer som du skapar för uppdateringshändelser för arbetsobjekt i områdessökvägen XYZ skickar inte meddelanden om du saknar åtkomst till dessa arbetsobjekt. Du kan dock se meddelandehistoriken för andra användare som har åtkomst till dessa arbetsobjekt.
F: Kan jag skapa tjänstkrokprenumerationer för ett projekt programmatiskt?
S: Ja. Mer information finns i Skapa en prenumeration för tjänstkrokar.
F: Kan jag ta bort en apps åtkomst till min organisation när jag har godkänt den?
S: Ja. Du kan återkalla auktoriseringar från din profil.
Gå till din profilsida från https://visualstudio.microsoft.com/.
Se till att du börjar från Visual Studio-webbplatsen (https://visualstudio.microsoft.com/) i stället för din organisation (
https://dev.azure.com/{orgName}) eftersom din profil som nås från din organisation tar dig till fel implementering av funktionen för auktoriseringshantering.Hantera dina auktoriseringar.
Återkalla alla auktoriseringar som du inte längre vill tillåta.
F: Varför kan vi inte konfigurera tjänstkrokar för HipChat längre?
S: Atlassian tappade officiellt stödet för HipChat. Mer information finns i meddelandet.