Dela via


Integrera med servicekrokar

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Du kan använda tjänstkrokar för att köra uppgifter på andra tjänster när händelser inträffar i ditt Azure DevOps-projekt.

Du kan till exempel använda en tjänstkrok för att automatiskt skapa ett kort i Trello när ett arbetsobjekt skapas i Azure DevOps. Eller så kan du automatiskt skicka ett push-meddelande till teamets mobila enheter när en version 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 service hooks?

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ändelser.

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.

Diagram med en pil med etiketten Händelse från en utgivarruta till en prenumerationsruta och pilar från prenumerationsrutan till konsument- och åtgärdsrutor.

Kommentar

Om du vill använda tjänstkrokar måste du tillåta specifika IP-adressintervall för inkommande anslutningar till tjänstslutpunkter. En tjänstslutpunkt är en uppsättning egenskaper som tillhandahålls till en tjänstkrok. Mer information finns i IP-adresser och intervallbegränsningar.

Tillgängliga tjänster

Följande tjänster är tillgängliga som mål för tjänsteutlösare. Mer information om andra appar och tjänster som integreras med Azure DevOps finns i Visual Studio Marketplace.

Tjänst Händelser som stöds Åtgärder som stöds Prenumerationshantering
Visual Studio App Center Arbetsobjektet har uppdaterats Skicka ett meddelande I App Center
AppVeyor Kod push-överförd Utlösa en AppVeyor-bygga I AppVeyor
Azuqua Alla Publicera en händelse till ett flödesspråkobjekt (FLO) I Azuqua
Azure App Service Kod push-överförd Distribuera en webbapp I App Service
Azure Service Bus Alla Skicka ett meddelande till Azure Notification Hubs, en Service Bus-kö eller ett Service Bus-ämne I Azure DevOps
Azure Storage Alla Infoga ett meddelande i en lagringskö I Azure DevOps
Bambu Bygget har slutförts, koden har pushats Köa ett bygge I Azure DevOps
Datadog Alla Publicera en händelse i Datadog I Azure DevOps
Grafana Versionsdistributionen har slutförts Lägga till en anteckning i en Grafana-databas I Azure DevOps
Jenkins Bygg slutförd, kod pushad, PR-sammandragning försökt Utlösa en generisk build eller Git-build I Azure DevOps
Microsoft-team Alla Publicera ett meddelande till en kanal I Teams
MyGet Bygget har slutförts, koden har pushats Publicera ett NuGet-paket till MyGet, utlösa en MyGet-build I MyGet
Office 365 Alla Publicera ett meddelande till en grupp I Office 365
Slak Alla Publicera ett meddelande till en kanal I Azure DevOps
Trello Alla Skapa ett kort eller en lista I Azure DevOps
UserVoice Arbetsobjektet har skapats, arbetsobjektet har uppdaterats Skicka en länkad arbetsobjekthändelse På UserVoice
Webhooks Alla Publicera en begäran via HTTP I Azure DevOps
Meddelandeappar på arbetsplatsen Alla Skicka ett meddelande I meddelandeappar på arbetsplatsen
Zapier Alla Skicka ett meddelande På Zapier
Zendesk Arbetsobjekt som kommenterats Skapa en privat kommentar i ett ärende I Azure DevOps
Tjänst Händelser som stöds Åtgärder som stöds Prenumerationshantering
Azure Service Bus Alla Skicka ett meddelande till Azure Notification Hubs, en Service Bus-kö eller ett Service Bus-ämne I Azure DevOps
Azure Storage Alla Infoga ett meddelande i en lagringskö I Azure DevOps
Bambu Bygget har slutförts, koden har pushats Köa ett bygge I Azure DevOps
Datadog Alla Publicera en händelse i Datadog I Azure DevOps
Grafana Versionsdistributionen har slutförts Lägga till en anteckning i en Grafana-databas I Azure DevOps
Jenkins Bygg slutförd, kod pushad, PR-sammandragning försökt Utlösa en generisk build eller Git-build I Azure DevOps
Microsoft-team Alla Publicera ett meddelande till en kanal I Teams
Office 365 Alla Publicera ett meddelande till en grupp I Office 365
Slak Alla Publicera ett meddelande till en kanal I Azure DevOps
Trello Alla Skapa ett kort eller en lista I Azure DevOps
UserVoice Arbetsobjektet har skapats, arbetsobjektet har uppdaterats Skicka en länkad arbetsobjekthändelse På UserVoice
Webhooks Alla Publicera en begäran via HTTP I Azure DevOps
Zendesk Arbetsobjekt som kommenterats Skapa en privat kommentar i ett ärende I Azure DevOps

Skapa en prenumeration

Om du vill integrera en av dessa tjänster med Azure DevOps skapar du en prenumeration. I många fall måste du också konfigurera måltjänsten. Detaljerad information finns i dokumentationen för den tjänst som du vill integrera.

  1. Gå till projektet, välj Projektinställningar och välj sedan Tjänstkrokar.

    Skärmbild som visar ett Azure DevOps-projekt. På sidan är Projektinställningar och Tjänstkrokar markerade.

  2. Välj Skapa prenumeration.

    Skärmbild av sidan Service Hooks i ett Azure DevOps-projekt. Knappen Skapa prenumeration är markerad.

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

    Skärmbild av dialogrutan Tjänst. Många tjänster visas, Trello har valts och en beskrivning av Trello visas.

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

    Skärmbild av dialogrutan Utlösare. Händelsen för push-överförd kod är markerad. Filter anges på ett kodförråd och en grupp.

  5. Välj en åtgärd som ska köras på måltjänsten.

    Kommentar

    Vilka åtgärder som är tillgängliga beror på vilken typ av händelse du väljer.

    Skärmbild av dialogrutan Åtgärd. Skapa ett kort är markerat. Fält är tillgängliga för att ange en token, en tavla och andra inställningar.

  6. Kontrollera att inställningarna är korrekta genom att testa prenumerationen och sedan slutföra guiden.

    Skärmbild av fönstret Testmeddelande. På fliken Sammanfattning visar ett meddelande om en push-överföring statusen Lyckades.

    Skärmbild av fönstret Testavisering. Fliken Begäran visar en POST-begäran till Trello med information om en commit som pushades.

Vanliga frågor och svar

F: Vilka behörigheter behöver jag för att konfigurera en prenumeration?

S: Du behöver behörigheten Redigera prenumerationer och Visa prenumerationer . Som standard har endast projektadministratörer dessa behörigheter. Om du vill ge dem till andra användare direkt kan du använda ett kommandoradsverktyg eller REST API för säkerhet .

Information om hur du beviljar behörigheten Visa till en grupp finns i Ange vybehörighet för en grupp i tjänstkrokar.

F: Vilka är säkerhetskonsekvenserna av att bevilja behörigheter för Redigera prenumerationer och Visa prenumerationer?

S: En användare som har behörigheten Redigera prenumerationer och Visa prenumerationer kan:

  • Se alla prenumerationer i projektet.
  • Se meddelandehistoriken för alla prenumerationer i projektet.
  • Skapa valfri typ av tjänstehookprenumeration 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.

Anta till exempel att du skapar en prenumeration för att skicka ett meddelande när ett arbetsobjekt i en specifik områdessökväg uppdateras. Om du inte har åtkomst till arbetsobjekten i den områdessökvägen skickas inte meddelandena. Men om andra användare har åtkomst till arbetsobjekten kan du se meddelandehistoriken för prenumerationer som varnar dem om uppdateringar.

F: Kan jag skapa tjänstkrokprenumerationer för ett projekt programmatiskt?

S: Ja. Mer information finns i Skapa en tjänst hooks-prenumeration programmatiskt.

F: Kan jag ta bort en apps åtkomst till min organisation när jag har auktoriserat den?

S: Ja. Du kan återkalla auktoriseringar från din profil.

  1. Gå till https://visualstudio.microsoft.com. Välj ditt profilfoto och välj sedan Visual Studio-profil.

    Se till att du börjar från Visual Studio-webbplatsen, https://visualstudio.microsoft.com, när du hanterar auktoriseringar. Från den webbplatsen kan du komma åt rätt implementering av funktionen för auktoriseringshantering. Börja inte från din organisation (https://dev.azure.com/{organization-name}).

  2. Välj Hantera auktoriseringar.

    Skärmbild av en Visual Studio-profilsida med kontaktinformation för en användare. I avsnittet Auktoriseringar är Hantera program markerat.

  3. Återkalla alla auktoriseringar som du inte längre vill tillåta.

    Skärmbild av dialogrutan Auktoriseringar. En lista med behörigheter visas och en återkalla-länk är markerad.

F: Varför kan jag inte konfigurera tjänstkrokar för HipChat längre?

S: Atlassian stöder inte längre HipChat. Mer information finns i Vanliga frågor och svar om Atlassian.