Integrera med tjänstkrokar

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Med tjänsthookar kan du köra uppgifter i 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-utgivaredefinierar 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
AppVeyor	Kod push-överförd	Utlösa en AppVeyor-version
Azuqua	Alla	Publicera händelsen till FLO
Azure App Service	Kod push-överförd	Distribuera webbapp
Azure Service Bus	Alla	Skicka ett meddelande till en Meddelandehubb, Service Bus-kö eller Service Bus-ämne
Azure Storage	Alla	Infoga ett meddelande i en lagringskö
Bambu	Bygget har slutförts, koden har push-överförts	Köa ett bygge
Campfire	Alla	Skicka ett meddelande till ett rum
Datadog	Alla	Publicera en händelse i Datadog
Grafana	Versionsdistributionen har slutförts	Lägga till anteckning i Grafana-databasen
HipChat	(Stöds inte längre)
HockeyApp	Arbetsobjektet har uppdaterats	Skicka meddelande
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
MyGet	Bygget har slutförts, koden har push-överförts	Publicera NuGet-paketet till MyGet, utlösa en MyGet-version
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	Arbetsobjekt som skapats eller uppdaterats	Skicka händelse för länkat arbetsobjekt
Webbkrokar	Alla	Publicera via HTTP
Meddelandeappar för arbetsplats	Alla	Skicka aviseringar
Zapier	Alla	Skicka meddelande
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å utföra en del arbete i den andra tjänsten. Mer information finns i informationen om tjänsten som du är intresserad av.

1. Öppna administratörssidan för ett projekt i webbåtkomst.

   

2. Kör guiden för att skapa prenumerationen.

   

3. Välj den tjänst som du vill integrera med.

   

4. Välj den händelse som ska utlösas och eventuella tillämpliga filter.

   

5. 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.

   

6. 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.

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: Om du inte har åtkomst till arbetsobjekt i områdessökvägen XYZ och du konfigurerar en prenumeration på arbetsobjektuppdateringshändelserna får du inga meddelanden om uppdateringar av arbetsobjekt i områdessökvägen XYZ. Men om en annan användare, som har åtkomst till arbetsobjekten i områdessökvägen XYZ, tar emot dessa "uppdateringshändelser för arbetsobjekt", kan du se meddelandehistoriken för den andra användarens händelser, som innehåller arbetsobjektsdata som du annars inte har åtkomst till.

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.

1. 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.

2. Hantera dina auktoriseringar.

   

3. Å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. Se mer om det tillkännagivandet här.

Relaterade artiklar

• Felsöka tjänstkrokar och vanliga frågor och svar
• Visual Studio Marketplace
• Faktureringsinformation