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 wyśle powiadomienie wypychane 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

Punkty zaczepienia usługi wymagają zezwolenia na zakresy adresów IP dla połączenia przychodzącego z punktami końcowymi 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 Wypchnięty kod Wdrażanie aplikacji internetowej. Subskrypcje są zarządzane za pośrednictwem usługi aplikacja systemu Azure.
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 aplikacja systemu Azure Service.
Azure Storage wszystkie Wstaw komunikat w kolejce magazynu.
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ę, wypchnięty kod, podjęto próbę scalenia żądania ściągnięcia, ukończono wdrożenie wydania Wyzwalanie kompilacji ogólnej lub git.
Microsoft Teams wszystkie Opublikuj wiadomość w kanale. Subskrypcje są zarządzane w usłudze Microsoft Teams.
MyGet Ukończono kompilację, wypchnięty kod Opublikuj pakiet NuGet w usłudze MyGet. Wyzwalanie kompilacji 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 połączone zdarzenie 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 komunikat do centrum powiadomień, kolejki usługi Service Bus lub tematu usługi Service Bus. Subskrypcja jest zarządzana za pośrednictwem usługi aplikacja systemu Azure Service.
Azure Storage wszystkie Wstaw komunikat w kolejce magazynu.
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ę, wypchnięty kod, podjęto próbę scalenia żądania ściągnięcia, ukończono wdrożenie wydania Wyzwalanie kompilacji ogólnej 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 połączone zdarzenie 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 do wyzwolenia i wszystkie odpowiednie filtry.

    Wybierz zdarzenie do wyzwolenia i wszystkie 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 muszę skonfigurować subskrypcję?

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

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 utworzyć w tym projekcie dowolny typ subskrypcji elementu service hook. Jeśli użytkownik skonfiguruje subskrypcję dla zasobu, do którego nie ma uprawnień dostępu, subskrypcja nie zostanie wyzwolona.

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 autoryzowanym dostępie?

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 przedstawiający opcję Odwołaj dla autoryzacji.

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

O: Atlassian oficjalnie spadła poparcie dla HipChat. Aby uzyskać więcej informacji, zobacz ogłoszenie.