Udostępnij za pośrednictwem


Integracja z punktami zaczepienia usługi

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Punkty zaczepienia usługi umożliwiają uruchamianie zadań w innych usługach w przypadku wystąpienia zdarzeń w projekcie w usłudze Azure DevOps.

Na przykład możesz utworzyć kartę w aplikacji Trello, gdy element roboczy zostanie utworzony lub wysłać powiadomienie push na urządzenia przenośne twojego zespołu, gdy kompilacja zakończy się niepowodzeniem. Możesz również używać punktów zaczepienia usług w niestandardowych aplikacjach i usługach jako bardziej wydajny sposób na prowadzenie działań w przypadku wystąpienia zdarzeń w projektach.

Jak działają punkty zaczepienia usług?

Wydawcy punktów zaczepienia usługi definiują zestaw zdarzeń, do których można zasubskrybować. Subskrypcje nasłuchują tych zdarzeń i definiują akcje do wykonania na podstawie zdarzenia.

Subskrypcje są również przeznaczone dla użytkowników, które są usługami zewnętrznymi, które mogą uruchamiać własne akcje w przypadku wystąpienia zdarzeń.

Diagram punktów zaczepienia usługi.

Uwaga

Zaczepy usługi wymagają zezwolenia na zakresy adresów IP dla połączeń przychodzących do punktów końcowych usługi. Punkt końcowy usługi to zestaw właściwości dostarczonych do punktu zaczepienia usługi. Aby uzyskać więcej informacji, zobacz Dozwolone listy adresów i połączenia sieciowe, adresy IP i ograniczenia zakresu.

Dostępne usługi

Następujące usługi są dostępne jako element docelowy punktów zaczepienia usługi. Aby uzyskać więcej informacji na temat innych aplikacji i usług, które integrują się z usługą Azure DevOps, przejdź do witryny Visual Studio Marketplace.

Usługa Obsługiwane zdarzenia Obsługiwane akcje
Centrum aplikacji Zaktualizowano element roboczy Wyślij powiadomienie. Subskrypcje są zarządzane za pośrednictwem Centrum aplikacji.
AppVeyor Wypchnięty kod Wyzwalanie kompilacji aplikacji AppVeyor. Subskrypcje są zarządzane za pośrednictwem usługi AppVeyor.
Azuqua wszystkie Opublikuj zdarzenie na flo. Subskrypcje są zarządzane za pośrednictwem usługi Azuqua.
Azure App Service Kod przesłany Wdrażanie aplikacji internetowej. Subskrypcje są zarządzane za pośrednictwem usługi Azure App Service.
Azure Service Bus wszystkie Wyślij komunikat do centrum powiadomień, kolejki usługi Service Bus lub tematu usługi Service Bus. Subskrypcja jest zarządzana za pośrednictwem usługi Azure App Service.
Azure Storage wszystkie Wstaw wiadomość w kolejce przechowywania.
Bambus Ukończono kompilację, wypchnięty kod Kolejkowanie kompilacji.
Datadog wszystkie Opublikuj zdarzenie w usłudze Datadog.
Grafana Ukończono wdrażanie wydania Dodaj adnotację do bazy danych Grafana.
Jenkins Ukończono kompilację, kod został wypchnięty do repozytorium, spróbowano zmergować pull request, zakończono wdrożenie wersji. Wyzwól kompilację ogólną lub kompilację Git.
Microsoft Teams wszystkie Opublikuj wiadomość w kanale. Subskrypcje są zarządzane w usłudze Microsoft Teams.
MyGet Ukończono budowanie, kod przesłano Opublikuj pakiet NuGet w usłudze MyGet. Uruchom kompilację MyGet. Subskrypcje są zarządzane przez usługę MyGet.
Office 365 wszystkie Opublikuj wiadomość w grupie.
Slack wszystkie Opublikuj wiadomość w kanale.
Trello wszystkie Utwórz kartę lub listę.
UserVoice Utworzony element roboczy, zaktualizowany element roboczy Wyślij zdarzenie powiązanego elementu roboczego. Subskrypcje są zarządzane za pośrednictwem usługi UserVoice.
Web Hooks wszystkie Opublikuj za pośrednictwem protokołu HTTP.
Aplikacje wiadomości w miejscu pracy wszystkie Wysyłanie powiadomień. Subskrypcje są zarządzane za pośrednictwem aplikacji wiadomości w miejscu pracy.
Zapier wszystkie Wyślij powiadomienie. Subskrypcje są zarządzane za pośrednictwem usługi Zapier.
Zendesk Element roboczy skomentowany Utwórz prywatny komentarz w bilecie.
Usługa Obsługiwane zdarzenia Obsługiwane akcje
Azure Service Bus wszystkie Wyślij wiadomość do centrum powiadomień, Service Bus Queue lub Service Bus Topic. Subskrypcja jest zarządzana za pośrednictwem Azure App Service.
Azure Storage wszystkie Wstaw komunikat w kolejce magazynowej.
Bambus Budowanie ukończone, kod przesłany Kolejkowanie kompilacji.
Datadog wszystkie Opublikuj zdarzenie w usłudze Datadog.
Grafana Ukończono wdrażanie wydania Dodaj adnotację do bazy danych Grafana.
Jenkins Ukończono kompilację, kod przesłany, spróbowano scalić Pull Request, ukończono wdrożenie wersji Wyzwól kompilację ogólną lub Git.
Microsoft Teams wszystkie Opublikuj wiadomość w kanale. Subskrypcje są zarządzane w usłudze Microsoft Teams.
Office 365 wszystkie Opublikuj wiadomość w grupie.
Slack wszystkie Opublikuj wiadomość w kanale.
Trello wszystkie Utwórz kartę lub listę.
[UserVoice]((https://www.uservoice.com) Utworzony element roboczy, zaktualizowany element roboczy Wyślij zdarzenie powiązanego elementu roboczego. Subskrypcje są zarządzane za pośrednictwem usługi UserVoice.
Web Hooks wszystkie Opublikuj za pośrednictwem protokołu HTTP.
Zendesk Element roboczy skomentowany Utwórz prywatny komentarz w bilecie.

Tworzenie subskrypcji

Po zintegrowaniu jednej z tych usług z usługą Azure DevOps należy utworzyć nową subskrypcję. W wielu przypadkach należy również wykonać konfigurację w drugiej usłudze. Aby uzyskać szczegółowe informacje, zapoznaj się z informacjami dotyczącymi usługi, którą cię interesują.

  1. Otwórz stronę administratora projektu w dostępie internetowym.

    Zrzut ekranu przedstawiający wyróżniony przycisk Ustawienia projektu.
  2. Uruchom kreatora, aby utworzyć subskrypcję.

    Zrzut ekranu przedstawiający wyróżniony przycisk Utwórz subskrypcję.

  3. Wybierz usługę, z którą chcesz się zintegrować.

    Wybierz usługę do zintegrowania

  4. Wybierz zdarzenie, które ma zainicjować działanie, oraz wszelkie stosowne filtry.

    Wybierz zdarzenie do uruchomienia oraz dowolne filtry

  5. Wybierz akcję do uruchomienia w usłudze docelowej.

    Uwaga

    Lista dostępnych akcji może być ograniczona na podstawie wybranego typu zdarzenia.

    Zrzut ekranu przedstawiający wybór akcji dla usługi docelowej.

  6. Aby potwierdzić poprawność ustawień, przetestuj subskrypcję, a następnie zakończ pracę kreatora.

    Zrzut ekranu przedstawiający powiadomienie testowe 1.

    Zrzut ekranu przedstawiający powiadomienie testowe 2.

Często zadawane pytania

Jakie uprawnienia są potrzebne do skonfigurowania subskrypcji?

1: Edytuj subskrypcje i Wyświetl subskrypcje. Domyślnie tylko administratorzy projektu mają to uprawnienie. Aby udzielić ich bezpośrednio innym użytkownikom, możesz użyć narzędzia wiersza polecenia lub Security interfejsu API REST.

Aby przyznać uprawnienie Wyświetl dla grupy, zobacz Ustawianie uprawnień widoku dla grupy na stronie Punkty zaczepienia usługi.

.: Jakie są implikacje zabezpieczeń związane z udzielaniem uprawnień Edytuj subskrypcje i Wyświetlanie subskrypcji ?

1: Użytkownik z tymi uprawnieniami może zobaczyć wszystkie subskrypcje utworzone w projekcie i historię powiadomień dla tych subskrypcji. Ten użytkownik może następnie w tym projekcie utworzyć dowolny typ subskrypcji usługi hook. Jeśli użytkownik skonfiguruje subskrypcję dla zasobu, do którego nie ma uprawnień dostępu, subskrypcja nie zostanie uruchomiona.

Na przykład: Subskrypcje tworzone dla zdarzeń aktualizacji elementów roboczych w ścieżce obszaru XYZ nie będą wysyłać powiadomień, jeśli nie masz dostępu do tych elementów roboczych. Można jednak zobaczyć historię powiadomień innych użytkowników, którzy mają dostęp do tych elementów roboczych.

.: Czy mogę programowo utworzyć subskrypcje elementu service hook dla projektu?

Odpowiedź: Tak. Aby uzyskać więcej informacji, zobacz Tworzenie subskrypcji punktów zaczepienia usługi.

Czy mogę usunąć dostęp aplikacji do mojej organizacji po jej autoryzacji?

Odpowiedź: Tak. Autoryzacje można odwołać z profilu.

  1. Przejdź do strony profilu z witryny https://visualstudio.microsoft.com/.

    Upewnij się, że rozpoczynasz od witryny programu Visual Studio () zamiast organizacji (https://visualstudio.microsoft.com/https://dev.azure.com/{orgName}), ponieważ dostęp do profilu z organizacji spowoduje przejście do niewłaściwej implementacji funkcji zarządzania autoryzacjami.

  2. Zarządzanie autoryzacjami.

    Zrzut ekranu przedstawiający wyróżniony przycisk Zarządzaj aplikacjami.

  3. Odwoływanie wszelkich autoryzacji, na które nie chcesz już zezwalać.

    Zrzut ekranu pokazujący opcję Odwołaj dla autoryzacji.

Pytanie: Dlaczego nie możemy już skonfigurować punktów zaczepienia usługi dla HipChat?

Atlassian oficjalnie zakończył wsparcie na HipChat. Aby uzyskać więcej informacji, zobacz ogłoszenie.