Integrace se služebními hooky

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

Pomocí háků služby můžete spouštět úkoly na jiných službách, když dojde k událostem v projektu Azure DevOps.

Například pomocí háku služby můžete automaticky vytvořit kartu v Trello, když se pracovní položka vytvoří v Azure DevOps. Nebo můžete automaticky odeslat push oznámení na mobilní zařízení vašeho týmu, když se build nezdaří. Háky služeb můžete použít také ve vlastních aplikacích a službách jako efektivnější způsob, jak řídit aktivity v případě, že dojde k událostem ve vašich projektech.

Jak fungují web hooky?

Vydavatelé háku služby definují sadu událostí, ke kterým se můžete přihlásit. Odběry naslouchají těmto událostem a definují akce , které se mají provést na základě událostí.

Předplatná také cílí na uživatele, což jsou externí služby, které můžou při výskytu událostí spouštět vlastní akce.

Diagram se šipkou s označením Událost z rámečku vydavatele do rámečku předplatného a šipkami z rámečku předplatného do rámečků příjemce a akcí.

Poznámka:

Pokud chcete používat háky služby, musíte povolit konkrétní rozsahy IP adres pro příchozí připojení ke koncovým bodům služby. Koncový bod služby je sada vlastností poskytovaných háku služby. Další informace naleznete v tématu IP adresy a omezení rozsahu.

Dostupné služby

Následující služby jsou k dispozici jako cíle propojovacích bodů služeb. Další informace o dalších aplikacích a službách, které se integrují s Azure DevOps, najdete na webu Visual Studio Marketplace.

Služba Podporované události Podporované akce Správa předplatného
Visual Studio App Center Aktualizovaná pracovní položka Odeslání oznámení V App Centeru
AppVeyor Vložený kód Aktivace sestavení AppVeyor V AppVeyoru
Azuqua Všechny Publikování události do objektu jazyka toku (FLO) V Azuqua
Azure App Service Vložený kód Nasazení webové aplikace Ve službě App Service
Azure Service Bus Všechny Odeslání zprávy do služby Azure Notification Hubs, fronty služby Service Bus nebo tématu služby Service Bus V Azure DevOps
Azure Storage Všechny Vložení zprávy do fronty úložiště V Azure DevOps
Bambus Sestavení dokončeno, kód odeslán Vytvoření fronty sestavení V Azure DevOps
Datadog Všechny Publikování události v Datadogu V Azure DevOps
Grafana Nasazení vydané verze bylo dokončeno. Přidání poznámky do databáze Grafana V Azure DevOps
Jenkins Sestavení dokončeno, kód odeslán, pokus o sloučení PR Aktivace obecného sestavení nebo sestavení Git V Azure DevOps
Microsoft Teams Všechny Publikování zprávy do kanálu V Teams
MyGet Sestavení dokončeno, kód odeslán Publikování balíčku NuGet do MyGetu, aktivace sestavení MyGet V MyGet
Office 365 Všechny Publikování zprávy do skupiny V Office 365
Slack Všechny Publikování zprávy do kanálu V Azure DevOps
Trello Všechny Vytvoření karty nebo seznamu V Azure DevOps
UserVoice Vytvořená pracovní položka, aktualizovaná pracovní položka Odeslat událost propojenou s pracovní položkou Na UserVoice
Webhooky Všechny Odeslání požadavku prostřednictvím protokolu HTTP V Azure DevOps
Aplikace pro zasílání zpráv na pracovišti Všechny Odeslání oznámení V aplikacích pro zasílání zpráv na pracovišti
Zapier Všechny Odeslání oznámení V Zapieru
Zendesk Pracovní položka byla okomentována Vytvoření soukromého komentáře v lístku V Azure DevOps
Služba Podporované události Podporované akce Správa předplatného
Azure Service Bus Všechny Odeslání zprávy do služby Azure Notification Hubs, fronty služby Service Bus nebo tématu služby Service Bus V Azure DevOps
Azure Storage Všechny Vložení zprávy do fronty úložiště V Azure DevOps
Bambus Sestavení dokončeno, kód odeslán Vytvoření fronty sestavení V Azure DevOps
Datadog Všechny Publikování události v Datadogu V Azure DevOps
Grafana Nasazení vydané verze bylo dokončeno. Přidání poznámky do databáze Grafana V Azure DevOps
Jenkins Sestavení dokončeno, kód odeslán, pokus o sloučení PR Aktivace obecného sestavení nebo sestavení Git V Azure DevOps
Microsoft Teams Všechny Publikování zprávy do kanálu V Teams
Office 365 Všechny Publikování zprávy do skupiny V Office 365
Slack Všechny Publikování zprávy do kanálu V Azure DevOps
Trello Všechny Vytvoření karty nebo seznamu V Azure DevOps
UserVoice Vytvořená pracovní položka, aktualizovaná pracovní položka Odeslat událost propojenou s pracovní položkou Na UserVoice
Webhooky Všechny Odeslání požadavku prostřednictvím protokolu HTTP V Azure DevOps
Zendesk Pracovní položka byla okomentována Vytvoření soukromého komentáře v lístku V Azure DevOps

Vytvoření odběru

Pokud chcete integrovat jednu z těchto služeb s Azure DevOps, vytvoříte předplatné. V mnoha případech musíte také nakonfigurovat cílovou službu. Podrobné informace najdete v dokumentaci ke službě, kterou chcete integrovat.

  1. Přejděte do projektu, vyberte Nastavení projektu a pak vyberte Háčky služeb.

    Snímek obrazovky znázorňující projekt Azure DevOps Na straně jsou zvýrazněná nastavení projektu a háky služby.

  2. Vyberte Vytvořit předplatné.

    Snímek obrazovky se stránkou Hooks služby projektu Azure DevOps Tlačítko Vytvořit předplatné je zvýrazněné.

  3. Vyberte službu, kterou chcete integrovat.

    Snímek obrazovky s dialogovým oknem Služby. V seznamu je uvedeno množství služeb, je vybrán Trello a jeho popis je viditelný.

  4. Vyberte událost, která se má aktivovat, a všechny příslušné filtry.

    Snímek obrazovky s dialogem Aktivace. Událost odeslání kódu je vybrána. Filtry jsou nastaveny na úložiště a skupinu.

  5. Vyberte akci, která se má spustit v cílové službě.

    Poznámka:

    Dostupné akce závisí na typu vybrané události.

    Snímek obrazovky s dialogovým oknem Akce Je vybrána možnost Vytvořit kartu. Pole jsou k dispozici pro zadání tokenu, panelu a dalších nastavení.

  6. Pokud chcete ověřit správnost nastavení, otestujte předplatné a dokončete průvodce.

    Snímek obrazovky okna Testovací oznámení. Na kartě Souhrn se ve zprávě o push oznámení zobrazí stav Úspěšně dokončeno.

    Snímek obrazovky okna Testovací oznámení. Na kartě Žádost se zobrazí požadavek POST na Trello s informacemi o commit, který byl odeslán.

Nejčastější dotazy

Otázka: Jaká oprávnění potřebuji k nastavení předplatného?

A: Potřebujete oprávnění Upravit předplatná a Zobrazit předplatná . Ve výchozím nastavení mají tato oprávnění pouze správci projektů. Pokud jim chcete udělit přístup přímo jiným uživatelům, můžete použít nástroj příkazového řádku nebo rozhraní REST API zabezpečení .

Pokud chcete skupině udělit oprávnění k zobrazení , přečtěte si téma Nastavení oprávnění zobrazení pro skupinu v hácích služby.

Otázka: Jaké jsou důsledky zabezpečení při udělování oprávnění k úpravám předplatných a zobrazení oprávnění k předplatným?

A: Uživatel, který má oprávnění Upravit předplatná a Zobrazit předplatná , může:

  • Zobrazit všechna předplatná v projektu
  • Podívejte se na historii oznámení pro všechna předplatná v projektu.
  • V projektu vytvořte libovolný typ předplatného hooku služby.

Pokud uživatel nastaví předplatné pro prostředek, ke kterému jinak nemá oprávnění k přístupu, předplatné se neaktivuje.

Předpokládejme například, že vytvoříte předplatné, které odešle oznámení, když se aktualizuje pracovní položka v příslušném oblasti. Pokud nemáte přístup k pracovním položkám v této oblasti, oznámení se neodesílají. Pokud ale k pracovním položkám mají přístup jiní uživatelé, uvidíte historii oznámení pro odběry, která je upozorňují na aktualizace.

Otázka: Můžu pro projekt programově vytvořit předplatná háku služby?

Odpověď: Ano. Další informace naleznete v tématu Vytvoření předplatného služebních háčků programově.

Otázka: Můžu po autorizaci odebrat přístup aplikace ke své organizaci?

Odpověď: Ano. Autorizaci můžete odvolat ze svého profilu.

  1. Přejděte na https://visualstudio.microsoft.com . Vyberte profilové fotky a pak vyberte profil sady Visual Studio.

    Při správě autorizací se ujistěte, že začínáte z webu Visual Studio https://visualstudio.microsoft.com. Z tohoto webu máte přístup ke správné implementaci funkce správy autorizací. Nezačínejte od vaší organizace (https://dev.azure.com/{organization-name}).

  2. Vyberte Spravovat autorizace.

    Snímek obrazovky se stránkou profilu sady Visual Studio s kontaktními informacemi pro uživatele V části Autorizace je zvýrazněná možnost Spravovat aplikace.

  3. Odvoláte všechny autorizace, které už nechcete povolit.

    Snímek obrazovky s dialogovým oknem Autorizace Zobrazí se seznam oprávnění a zvýrazněný odkaz Odvolat.

Otázka: Proč už nemůžu nastavit háky služby pro HipChat?

A: Atlassian už nepodporuje HipChat. Další informace najdete v tématu Atlassian – nejčastější dotazy.