Udostępnij przez


Integracja z hookami serwisowymi

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

Za pomocą hooków serwisowych można uruchamiać zadania w zewnętrznych usługach w przypadku zdarzeń w projekcie Azure DevOps.

Możesz na przykład użyć hooka usługi, aby automatycznie utworzyć kartę w Trello po utworzeniu elementu roboczego w usłudze Azure DevOps. Możesz też automatycznie wysłać powiadomienie push na urządzenia mobilne 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ą zdarzeń i określają akcje do podjęcia w oparciu o 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 ze strzałką oznaczoną Zdarzenie prowadzącą z pola wydawcy do pola subskrypcji oraz strzałki z pola subskrypcji do pola odbiorcy i pola akcji.

Uwaga

Aby korzystać z punktów zaczepienia usługi, należy zezwolić na określone zakresy adresów IP dla połączeń przychodzących 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 Adresy IP i ograniczenia zakresu.

Dostępne usługi

Następujące usługi są dostępne jako punkty integracji usług. Aby uzyskać więcej informacji na temat innych aplikacji i usług, które integrują się z usługą Azure DevOps, zobacz witrynę Visual Studio Marketplace.

Usługa Obsługiwane zdarzenia Obsługiwane akcje Zarządzanie subskrypcjami
Visual Studio App Center Zaktualizowano element roboczy Wysyłanie powiadomienia W centrum aplikacji
AppVeyor Wypchnięty kod Wyzwalanie kompilacji aplikacji AppVeyor W aplikacji AppVeyor
Azuqua wszystkie Publikowanie zdarzenia w obiekcie języka przepływu (FLO) W Azuqua
Azure App Service Wypchnięty kod Wdrażanie aplikacji internetowej W usłudze App Service
Azure Service Bus wszystkie Wysyłanie komunikatu do usługi Azure Notification Hubs, kolejki usługi Service Bus lub tematu usługi Service Bus W usłudze Azure DevOps
Azure Storage wszystkie Wstaw komunikat w kolejce Storage W usłudze Azure DevOps
Bambus Ukończono budowanie, kod przesłano Kolejkowanie kompilacji W usłudze Azure DevOps
Datadog wszystkie Publikowanie zdarzenia w usłudze Datadog W usłudze Azure DevOps
Grafana Wdrażanie wydania zostało ukończone Dodawanie adnotacji do bazy danych Grafana W usłudze Azure DevOps
Jenkins Build ukończony, przesłany kod, próba połączenia PR Wyzwól kompilację ogólną lub Git W usłudze Azure DevOps
Microsoft Teams wszystkie Publikowanie wiadomości w kanale W aplikacji Teams
MyGet Ukończono budowanie, kod przesłano Publikowanie pakietu NuGet w usłudze MyGet, wyzwalanie kompilacji MyGet W obszarze MyGet
Office 365 wszystkie Publikowanie wiadomości w grupie W usłudze Office 365
Luzu wszystkie Publikowanie wiadomości w kanale W usłudze Azure DevOps
Trello wszystkie Tworzenie karty lub listy W usłudze Azure DevOps
UserVoice Utworzony element roboczy, zaktualizowany element roboczy Wysyłanie połączonego zdarzenia elementu roboczego W usłudze UserVoice
Elementy webhook wszystkie Publikowanie żądania za pośrednictwem protokołu HTTP W usłudze Azure DevOps
Aplikacje do obsługi komunikatów w miejscu pracy wszystkie Wysyłanie powiadomienia W aplikacjach do obsługi komunikatów w miejscu pracy
Zapier wszystkie Wysyłanie powiadomienia W usłudze Zapier
Zendesk Element roboczy skomentowany Tworzenie prywatnego komentarza w bilecie W usłudze Azure DevOps
Usługa Obsługiwane zdarzenia Obsługiwane akcje Zarządzanie subskrypcjami
Azure Service Bus wszystkie Wysyłanie komunikatu do usługi Azure Notification Hubs, kolejki usługi Service Bus lub tematu usługi Service Bus W usłudze Azure DevOps
Azure Storage wszystkie Wstaw komunikat w kolejce Storage W usłudze Azure DevOps
Bambus Ukończono budowanie, kod przesłano Kolejkowanie kompilacji W usłudze Azure DevOps
Datadog wszystkie Publikowanie zdarzenia w usłudze Datadog W usłudze Azure DevOps
Grafana Wdrażanie wydania zostało ukończone Dodawanie adnotacji do bazy danych Grafana W usłudze Azure DevOps
Jenkins Build ukończony, przesłany kod, próba połączenia PR Wyzwól kompilację ogólną lub Git W usłudze Azure DevOps
Microsoft Teams wszystkie Publikowanie wiadomości w kanale W aplikacji Teams
Office 365 wszystkie Publikowanie wiadomości w grupie W usłudze Office 365
Luzu wszystkie Publikowanie wiadomości w kanale W usłudze Azure DevOps
Trello wszystkie Tworzenie karty lub listy W usłudze Azure DevOps
UserVoice Utworzony element roboczy, zaktualizowany element roboczy Wysyłanie połączonego zdarzenia elementu roboczego W usłudze UserVoice
Elementy webhook wszystkie Publikowanie żądania za pośrednictwem protokołu HTTP W usłudze Azure DevOps
Zendesk Element roboczy skomentowany Tworzenie prywatnego komentarza w bilecie W usłudze Azure DevOps

Tworzenie subskrypcji

Aby zintegrować jedną z tych usług z usługą Azure DevOps, należy utworzyć subskrypcję. W wielu przypadkach należy również skonfigurować usługę docelową. Aby uzyskać szczegółowe informacje, zobacz dokumentację usługi, którą chcesz zintegrować.

  1. Przejdź do projektu, wybierz pozycję Ustawienia projektu, a następnie wybierz pozycję Punkty zaczepienia usługi.

    Zrzut ekranu przedstawiający projekt usługi Azure DevOps. Po stronie wyróżniono ustawienia projektu i punkty zaczepienia usługi.

  2. Wybierz pozycję Utwórz subskrypcję.

    Zrzut ekranu strony Service Hooks projektu Azure DevOps. Przycisk Utwórz subskrypcję jest wyróżniony.

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

    Zrzut ekranu przedstawiający okno dialogowe Usługa. Na liście dostępnych jest wiele usług, wybrano aplikację Trello, a opis aplikacji Trello jest widoczny.

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

    Zrzut ekranu przedstawiający okno dialogowe Wyzwalacz. Wybrano zdarzenie wypchnięcia kodu. Filtry są ustawione dla repozytorium i grupy.

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

    Uwaga

    Dostępne akcje zależą od wybranego typu zdarzenia.

    Zrzut ekranu przedstawiający okno dialogowe Akcja. Opcja Utwórz kartę jest wybrana. Pola są dostępne do określania tokenu, tablicy i innych ustawień.

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

    Zrzut ekranu przedstawiający okno Powiadomienie testowe. Na karcie Podsumowanie komunikat o pushu ma status Powodzenie.

    Zrzut ekranu przedstawiający okno Powiadomienie testowe. Karta Żądanie zawiera żądanie POST do Trello z informacjami o zatwierdzeniu, które zostało dodane.

Często zadawane pytania

Jakie uprawnienia są potrzebne do skonfigurowania subskrypcji?

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

Aby przyznać grupie uprawnienie Wyświetl, zobacz Ustaw uprawnienie Wyświetl dla grupy w powiązaniach usługi.

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

1: Użytkownik, który ma uprawnienia Edytuj subskrypcje i Wyświetl subskrypcje , może:

  • Zobacz wszystkie subskrypcje w projekcie.
  • Zobacz historię powiadomień dla wszystkich subskrypcji w projekcie.
  • Utwórz w projekcie dowolny typ subskrypcji elementu service hook.

Jeśli użytkownik konfiguruje subskrypcję zasobu, do którego w przeciwnym razie nie ma uprawnień dostępu, subskrypcja się nie aktywuje.

Załóżmy na przykład, że tworzysz subskrypcję, aby wysłać powiadomienie, kiedy element roboczy w określonej ścieżce obszaru zostanie zaktualizowany. Jeśli nie masz dostępu do elementów roboczych w tej ścieżce obszaru, powiadomienia nie będą wysyłane. Jeśli jednak inni użytkownicy mają dostęp do elementów roboczych, możesz zobaczyć historię powiadomień dla subskrypcji, które ostrzegają ich o aktualizacjach.

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

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

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

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

  1. Przejdź do https://visualstudio.microsoft.com. Wybierz zdjęcie profilu, a następnie wybierz Profil programu Visual Studio.

    Upewnij się, że rozpoczynasz od witryny programu Visual Studio, https://visualstudio.microsoft.com, podczas zarządzania autoryzacjami. Z tej witryny można uzyskać dostęp do poprawnej implementacji funkcji zarządzania autoryzacjami. Nie zaczynaj od organizacji (https://dev.azure.com/{organization-name}).

  2. Wybierz pozycję Zarządzaj autoryzacjami.

    Zrzut ekranu przedstawiający stronę profilu programu Visual Studio z informacjami kontaktowymi dla użytkownika. W sekcji Autoryzacje wyróżniono pozycję Zarządzaj aplikacjami.

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

    Zrzut ekranu przedstawiający okno dialogowe Autoryzacje. Lista uprawnień jest widoczna, a link Odwołaj jest wyróżniony.

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

1: Atlassian nie obsługuje już HipChat. Aby uzyskać więcej informacji, zobacz Atlassian Frequently Asked Questions (Atlassian — często zadawane pytania).