Integracja z punktami zaczepienia usługi

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

Wpięcia usługi umożliwiają uruchamianie zadań w innych usługach, gdy w projekcie w usłudze Azure DevOps występują zdarzenia.

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.

Available services (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 Wysyłanie powiadomienia
AppVeyor Wypchnięty kod Wyzwalanie kompilacji aplikacji AppVeyor
Azuqua wszystkie Publikowanie zdarzenia na flo
Azure App Service Wypchnięty kod Wdrażanie aplikacji internetowej
Azure Service Bus wszystkie Wysyłanie komunikatu do centrum powiadomień, kolejki usługi Service Bus lub tematu usługi Service Bus
Azure Storage wszystkie Wstawianie komunikatu w kolejce magazynu
Bambus Ukończono kompilację, wypchnięty kod Kolejkowanie kompilacji
Campfire wszystkie Publikowanie wiadomości w pokoju
Datadog wszystkie Publikowanie zdarzenia w usłudze Datadog
Grafana Ukończono wdrażanie wydania Dodawanie adnotacji do bazy danych Grafana
HipChat (Nieobsługiwane)
HockeyApp Zaktualizowano element roboczy Wysyłanie powiadomienia
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 Publikowanie wiadomości w kanale
MyGet Ukończono kompilację, wypchnięty kod Publikowanie pakietu NuGet w usłudze MyGet, wyzwalanie kompilacji MyGet
Office 365 wszystkie Publikowanie wiadomości w grupie
Slack wszystkie Publikowanie wiadomości w kanale
Trello wszystkie Tworzenie karty lub listy
UserVoice Element roboczy utworzony lub zaktualizowany Wysyłanie zdarzenia połączonego elementu roboczego
Web Hooks wszystkie Publikowanie za pośrednictwem protokołu HTTP
Aplikacje wiadomości w miejscu pracy wszystkie Wysyłanie powiadomień
Zapier wszystkie Wysyłanie powiadomienia
Zendesk Element roboczy skomentowany Tworzenie prywatnego komentarza 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ć jakąś pracę w drugiej usłudze. Aby uzyskać szczegółowe informacje, zapoznaj się z informacjami na temat 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

Pyt.: 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ń.

Pyt.: 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ę zasobu, do którego nie ma uprawnień dostępu, subskrypcja nie zostanie wyzwolona.

Na przykład: Jeśli nie masz dostępu do elementów roboczych w ścieżce obszaru XYZ i skonfigurujesz subskrypcję zdarzeń aktualizacji elementu roboczego, nie otrzymasz powiadomień o aktualizacjach elementów roboczych w ścieżce obszaru XYZ. Jeśli jednak inny użytkownik, który ma dostęp do elementów roboczych w ścieżce obszaru XYZ, otrzyma te zdarzenia "aktualizacji elementu roboczego", zobaczysz historię powiadomień zdarzeń innych użytkowników, która zawiera dane elementów roboczych, do których nie masz dostępu.

Pyt.: 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.

Pyt.: 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.

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

O: Atlassian oficjalnie spadła poparcie dla HipChat. Więcej informacji na ten temat można znaleźć tutaj.