Integrace s hooky služeb

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

Volané služby umožňují spouštět úlohy v jiných službách, když dojde k událostem ve vašem projektu v Azure DevOps.

Můžete například vytvořit kartu v Trello, když se vytvoří pracovní položka, nebo odeslat nabízené oznámení na mobilní zařízení vašeho týmu, když se sestavení 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í háky služby?

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álosti.

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 háků služby

Poznámka:

Volání služeb vyžadují povolení rozsahů 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 najdete v tématu Povolené seznamy adres a síťová připojení, IP adresy a omezení rozsahu.

Dostupné služby

Následující služby jsou k dispozici jako cíl volání 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
App Center Aktualizovaná pracovní položka Odeslat oznámení
AppVeyor Vložený kód Aktivace sestavení AppVeyor
Azuqua Vše Post event to FLO
Azure App Service Vložený kód Nasazení webové aplikace
Azure Service Bus Vše Odeslání zprávy do centra oznámení, fronty služby Service Bus nebo tématu služby Service Bus
Azure Storage Vše Vložení zprávy do fronty úložiště
Bambusové Sestavení dokončeno, vložený kód Vytvoření fronty sestavení
Campfire Vše Odeslání zprávy do místnosti
Datadog Vše Publikování události v Datadogu
Grafana Nasazení vydané verze bylo dokončeno. Přidání poznámky do databáze Grafana
HipChat (Už se nepodporuje)
HockeyApp Aktualizovaná pracovní položka Odeslat oznámení
Jenkins Sestavení dokončeno, vložený kód, pokus o sloučení žádosti o přijetí změn, dokončené nasazení vydané verze Aktivace obecného sestavení nebo sestavení Git
Microsoft Teams Vše Publikování zprávy do kanálu
MyGet Sestavení dokončeno, vložený kód Publikování balíčku NuGet do MyGetu, aktivace sestavení MyGet
Office 365 Vše Publikování zprávy do skupiny
Slack Vše Publikování zprávy do kanálu
Trello Vše Vytvoření karty nebo seznamu
UserVoice Vytvořená nebo aktualizovaná pracovní položka Odeslání propojené události pracovní položky
WebHooky Vše Publikování prostřednictvím protokolu HTTP
Aplikace zpráv na pracovišti Vše Odeslání oznámení
Zapier Vše Odeslat oznámení
Zendesk Pracovní položka byla okomentována Vytvoření soukromého komentáře v lístku

Vytvoření odběru

Když integrujete jednu z těchto služeb s Azure DevOps, musíte vytvořit nové předplatné. V mnoha případech je potřeba udělat nějakou práci i v jiné službě. Konkrétní podrobnosti najdete v informacích o službě, kterou vás zajímají.

  1. Otevřete stránku správce projektu ve webovém přístupu.

    Snímek obrazovky se zvýrazněným tlačítkem Nastavení projektu
  2. Spuštěním průvodce vytvořte předplatné.

    Snímek obrazovky se zvýrazněným tlačítkem Vytvořit předplatné

  3. Vyberte službu, se kterou chcete integrovat.

    Vyberte službu, která se má integrovat.

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

    Vyberte událost, která se má aktivovat, a všechny filtry.

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

    Poznámka:

    Seznam dostupných akcí může být omezený na základě vybraného typu události.

    Snímek obrazovky znázorňující výběr akce pro cílovou službu

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

    Snímek obrazovky s testovacím oznámením 1

    Snímek obrazovky s testovacím oznámením 2

Nejčastější dotazy

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

A: Umožňuje upravit předplatná a zobrazit předplatná. Ve výchozím nastavení mají tato oprávnění pouze správci projektů. Pokud je chcete udělit přímo jiným uživatelům, můžete použít nástroj příkazového řádku nebo rozhraní REST API pro zabezpečení.

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 s těmito oprávněními může zobrazit všechna předplatná vytvořená v projektu a historii oznámení pro tato předplatná. Tento uživatel pak může v daném projektu vytvořit 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říklad: Pokud nemáte přístup k pracovním položkám v cestě oblasti XYZ a nastavíte odběr událostí aktualizace pracovní položky, nedostanete oznámení o aktualizacích pracovních položek v cestě oblasti XYZ. Pokud ale jiný uživatel, který má přístup k pracovním položkám v cestě oblasti XYZ, obdrží tyto události "aktualizace pracovní položky", pak můžete vidět historii oznámení událostí jiného uživatele, která zahrnuje data pracovních položek, ke kterým nemáte jinak přístup.

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

Odpověď: Ano. Další informace najdete v tématu Vytvoření předplatného hooků služby.

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 stránku svého profilu z https://visualstudio.microsoft.com/webu .

    Nezapomeňte začít z webu sady Visual Studio (https://visualstudio.microsoft.com/) místo vaší organizace (https://dev.azure.com/{orgName}), protože váš profil přístupný z vaší organizace vás provede chybnou implementací funkce správy autorizací.

  2. Správa autorizací

    Snímek obrazovky se zvýrazněným tlačítkem Spravovat aplikace

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

    Snímek obrazovky znázorňující možnost Odvolat pro autorizaci

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

A: Atlassian oficiálně zrušil podporu HipChatu. Další informace o tomto oznámení najdete tady.