Udostępnij za pośrednictwem

Usługa Azure Repos z usługą Slack

  • Artykuł

Azure DevOps Services

Jeśli używasz usługi Slack, możesz użyć aplikacji Azure Repos dla usługi Slack, aby łatwo monitorować repozytoria usługi Azure Repos. Skonfiguruj subskrypcje i zarządzaj nimi, aby otrzymywać powiadomienia w kanale za każdym razem, gdy kod jest wypychany lub zaewidencjonowany i za każdym razem, gdy żądanie ściągnięcia zostanie utworzone, zaktualizowane lub scalone. Ta aplikacja obsługuje zdarzenia usługi Git i usługi Kontrola wersji serwera Team Foundation (TFVC).

Wymagania wstępne

  • Aby utworzyć subskrypcje w kanale usługi Slack dla zdarzeń związanych z repozytorium, musisz być członkiem grupy project Administracja istrators lub być administratorem zespołu. Aby dodać, zobacz Zmienianie uprawnień na poziomie projektu lub Dodawanie administratora zespołu.
  • Aby otrzymywać powiadomienia, dla organizacji musi być włączony dostęp aplikacji innej firmy za pośrednictwem protokołu OAuth . Aby uzyskać więcej informacji, zobacz Zmienianie zasad dostępu do aplikacji dla organizacji.

Uwaga

  • Teraz możesz połączyć aplikację Azure Repos dla usługi Slack tylko z projektem hostowanym w usługach Azure DevOps Services.
  • Powiadomienia nie są obecnie obsługiwane w wiadomościach bezpośrednich.

Dodawanie aplikacji Azure Repos do obszaru roboczego usługi Slack

  1. Przejdź do aplikacji Azure Repos Slack i wybierz pozycję Dodaj do usługi Slack.

    Zrzut ekranu przedstawiający katalog aplikacji Slack, repozytoria platformy Azure i przycisk Dodaj do usługi Slack.

    Po dodaniu otrzymasz komunikat podobny do następującego komunikatu powitalnego.

    Zrzut ekranu przedstawiający komunikat powitalny z usługi Slack.

  2. Użyj dojścia /azrepos usługi Slack do interakcji z aplikacją. Pełna lista poleceń znajduje się w sekcji Informacje o poleceniach w tym artykule.

Połączenie aplikacji Azure Repos do repozytoriów

  1. Połączenie i uwierzytelnij się w usłudze Azure Repos przy użyciu /azrepos signin polecenia .

    Zrzut ekranu przedstawiający monit logowania dla usługi Slack.

  2. Wybierz Zaloguj.

  3. Zaakceptuj integrację usługi Slack z usługą Azure Repos.

    Zrzut ekranu przedstawiający przycisk Akceptuj na wyświetlonym ekranie logowania.

    Kod weryfikacyjny jest wyświetlany do użycia w aplikacji czatu w celu ukończenia uwierzytelniania.

  4. Skopiuj kod uwierzytelniania.

    Zrzut ekranu przedstawiający kod weryfikacyjny dostarczony przez usługę Azure Repos.

  5. Wybierz pozycję Wprowadź kod, wklej kod, a następnie wybierz pozycję Prześlij.

    Zrzut ekranu przedstawiający ekran uwierzytelniania końcowego po wklejeniu kodu weryfikacyjnego, a następnie wybraniu przycisku Prześlij.

    Potwierdzenie logowania jest wyświetlane w czacie.

    Zrzut ekranu przedstawiający potwierdzenie logowania w czacie.

Aby rozpocząć monitorowanie wszystkich repozytoriów Git w projekcie, użyj następującego polecenia ukośnika wewnątrz kanału:

/azrepos subscribe [project url]

Adres URL projektu może dotyczyć dowolnej strony w projekcie (z wyjątkiem adresów URL repozytoriów). Na przykład:

/azrepos subscribe https://dev.azure.com/myorg/myproject/

Można również monitorować określone repozytorium przy użyciu następującego polecenia:

/azrepos subscribe [repository url]

Adres URL repozytorium może być adresem dowolnej strony w repozytorium, która ma twoją nazwę repozytorium. Na przykład w przypadku repozytoriów Git użyj:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_git/myrepository

W przypadku repozytoriów TFVC użyj:

/azrepos subscribe https://dev.azure.com/myorg/myproject/_versionControl

Uwaga

Możesz subskrybować tylko repozytoria publiczne.

Polecenie subskrybuj powoduje rozpoczęcie pracy z domyślną subskrypcją. W przypadku repozytoriów Git kanał jest subskrybowany do zdarzenia utworzonego żądania ściągnięcia (z gałęzią docelową = main), a w przypadku repozytoriów TFVC kanał jest subskrybowany jako zdarzenie zaewidencjonowane w kodzie.

Zrzut ekranu przedstawiający komunikat tworzenia domyślnych subskrypcji.

Zarządzanie subskrypcjami

Aby wyświetlić, dodać lub usunąć subskrypcje dla kanału, użyj następującego subscriptions polecenia:

/azrepos subscriptions

To polecenie wyświetla listę wszystkich bieżących subskrypcji dla kanału i umożliwia dodawanie nowych subskrypcji lub usuwanie istniejących. Podczas dodawania subskrypcji można dostosować otrzymywane powiadomienia przy użyciu różnych filtrów, zgodnie z opisem w poniższej sekcji.

Uwaga

Administratorzy zespołu nie mogą usuwać ani modyfikować subskrypcji utworzonych przez administratorów projektu.

Zrzut ekranu przedstawiający widok listy subskrypcji.

Dostosowywanie subskrypcji przy użyciu filtrów

Gdy użytkownik subskrybuje repozytorium przy użyciu /azrepos subscribe polecenia , zostanie utworzona domyślna subskrypcja. Często użytkownicy muszą dostosowywać te subskrypcje. Na przykład użytkownicy mogą chcieć otrzymywać powiadomienia tylko wtedy, gdy żądania ściągnięcia mają określonego recenzenta.

W poniższych krokach pokazano, jak dostosować subskrypcje.

  1. Uruchom polecenie /azrepos subscriptions.
  2. Jeśli na liście subskrypcji istnieje subskrypcja, która jest niepożądane lub musi zostać zmodyfikowana (przykład: tworzenie szumu w kanale), wybierz przycisk Usuń .
  3. Wybierz przycisk Dodaj subskrypcję.
  4. Wybierz wymagane repozytorium i żądane zdarzenie.
  5. Wybierz odpowiednie filtry.

Przykład: otrzymywanie powiadomień tylko wtedy, gdy mój zespół znajduje się na liście recenzentów żądania ściągnięcia

Zrzut ekranu przedstawiający zespół recenzenta.

Przykład: Powiedz mi, kiedy próby scalania kończą się niepowodzeniem z powodu naruszenia zasad

Zrzut ekranu przedstawiający nieudaną próbę scalania — z powodu naruszenia zasad.

Uwaga

  • Wszystkie filtry są zwykle listami rozwijanych. Jeśli jednak lista rozwijana ma więcej niż 100 elementów, użytkownicy muszą ręcznie wprowadzić wartości.
  • W przypadku zdarzenia Zaewidencjonowany kod TFVC filtr w obszarze ścieżki musi mieć format $/myproject/path.

Adresy URL żądań ściągnięcia w wersji zapoznawczej

Gdy użytkownik wkleja adres URL żądania ściągnięcia, podgląd jest wyświetlany jak na poniższej ilustracji, co pomaga zachować kontekstowe i dokładne konwersacje związane z żądaniem ściągnięcia.

Zrzut ekranu przedstawia rozwieranie adresu URL.

Po zalogowaniu się użytkownicy ta funkcja działa dla wszystkich kanałów w obszarze roboczym.

Usuwanie subskrypcji i repozytoriów z kanału

Użyj następującego polecenia, aby wyczyścić kanał, usuwając repozytoria i subskrypcje.

/azrepos unsubscribe all [project url]

Na przykład następujące polecenie usuwa wszystkie subskrypcje powiązane z dowolnym repozytorium w projekcie i usuwa repozytoria z kanału. To polecenie mogą uruchamiać tylko administratorzy projektu.

/azrepos unsubscribe all https://dev.azure.com/myorg/myproject

Dokumentacja polecenia

W poniższej tabeli wymieniono /azrepos commands wszystkie elementy, których można użyć w kanale usługi Slack.

Polecenie slash Funkcje
/azrepos subscribe [adres URL repozytorium/ adres URL projektu] Subskrybowanie repozytorium lub wszystkich repozytoriów w projekcie w celu otrzymywania powiadomień
/azrepos subscriptions Dodawanie lub usuwanie subskrypcji dla tego kanału
/azrepos signin Zaloguj się do organizacji usługi Azure Repos
/azrepos signout Wyloguj się z organizacji usługi Azure Repos
/azrepos feedback Zgłaszanie problemu lub sugerowanie funkcji
/azrepos anuluj subskrypcję wszystkich [adres URL projektu] Usuwanie wszystkich repozytoriów (należących do projektu) i skojarzonych z nimi subskrypcji z kanału

Powiadomienia w kanałach prywatnych

Aplikacja Azure Repos może również ułatwić monitorowanie zdarzeń repozytorium w kanałach prywatnych. Zaproś bota do kanału prywatnego przy użyciu polecenia /invite @azrepos. Następnie możesz zarządzać powiadomieniami w taki sam sposób, jak w przypadku kanału publicznego.

Rozwiązywanie problemów

Jeśli podczas korzystania z aplikacji Azure Repos App for Slack występują następujące błędy, wykonaj procedury opisane w tej sekcji.

Niestety, wystąpił problem. Spróbuj ponownie.

Aplikacja Azure Repos używa protokołu uwierzytelniania OAuth i wymaga włączenia dostępu do aplikacji innej firmy za pośrednictwem protokołu OAuth dla organizacji . Aby włączyć to ustawienie, przejdź do pozycji Organizacja Ustawienia> Zasady zabezpieczeń>i ustaw opcję Dostęp aplikacji innej firmy za pośrednictwem protokołu OAuth dla ustawienia organizacji na Włączone.

Włączanie dostępu do aplikacji innej firmy za pośrednictwem protokołu OAuth dla ustawienia organizacji

Konfiguracja nie powiodła się. Upewnij się, że organizacja "{nazwa organizacji}" istnieje i że masz wystarczające uprawnienia.

Wyloguj się z usługi Azure DevOps, przechodząc do https://aka.ms/VsSignout przeglądarki.

Otwórz okno przeglądarki w trybie prywatnym lub incognito i przejdź do https://aex.dev.azure.com/me strony i zaloguj się. Na liście rozwijanej w obszarze ikony profilu po lewej stronie wybierz katalog zawierający organizację zawierającą repozytorium, do którego chcesz zasubskrybować.

Wybierz katalog zawierający organizację zawierającą projekt

W tej samej przeglądarce uruchom nową kartę, przejdź do https://slack.comadresu i zaloguj się do obszaru roboczego (użyj klienta internetowego). /azrepos signout Uruchom polecenie , a następnie /azrepos signin polecenie .

Sign in Wybierz przycisk i nastąpi przekierowanie do strony zgody, takiej jak w poniższym przykładzie. Upewnij się, że katalog wyświetlany obok wiadomości e-mail jest taki sam jak ten, który został wybrany w poprzednim kroku. Zaakceptuj i ukończ proces logowania.

Zrzut ekranu przedstawiający wyrażenie zgody na żądane uprawnienia aplikacji.

Jeśli te kroki nie rozwiążą problemu z uwierzytelnianiem, skontaktuj się z nami w społeczności deweloperów.