Udostępnij przez


Używanie usługi Azure Repos z usługą Microsoft Teams

Azure DevOps Services

Jeśli używasz usług Microsoft Teams i Azure Repos, możesz użyć aplikacji Azure Repos for Teams do monitorowania repozytoriów. Aplikacja obsługuje monitorowanie repozytoriów Git i Team Foundation Version Control (TFVC), ale nie obsługuje integracji z repozytoriami GitHub.

Z tego artykułu dowiesz się, jak wykonywać następujące zadania:

  • Dodawanie aplikacji Azure Repos do zespołu w usłudze Microsoft Teams
  • Łączenie aplikacji Azure Repos z repozytoriami
  • ** Zarządzaj subskrypcjami zdarzeń związanych z repozytorium w twoim kanale
  • Wyszukiwanie i udostępnianie informacji o żądaniu ściągnięcia przy użyciu rozszerzenia compose
  • Podgląd URL-ów PR
  • Usuwanie subskrypcji i repozytoriów z kanału

Wymagania wstępne

Kategoria Requirements
Uprawnienia — Aby utworzyć subskrypcje dla zdarzeń związanych z repozytorium, należy być członkiem grupy Administratorzy projektu lub administratorem zespołu. Aby uzyskać więcej informacji, zobacz Zmienianie uprawnień na poziomie projektu lub Dodawanie administratora zespołu.

Uwaga / Notatka

  • Aplikację Azure Repos dla usługi Microsoft Teams można połączyć tylko z projektem hostowanym w usłudze Azure DevOps Services.
  • Powiadomienia nie są obsługiwane w wiadomościach bezpośrednich.

Dodawanie aplikacji Azure Repos do zespołu w usłudze Microsoft Teams

  1. Przejdź do aplikacji Azure Repos w usłudze Microsoft Teams, Microsoft Teams > Azure Repos.

  2. Wybierz pozycję Dodaj lub jeśli aplikacja została już pobrana, wybierz menu rozwijane obok pozycji Otwórz, a następnie wybierz pozycję Dodaj do zespołu.

  3. Wprowadź nazwę zespołu lub kanału, a następnie wybierz pozycję Skonfiguruj bota.

    Zrzut ekranu przedstawiający wiadomość powitalną z usługi Azure Repos w usłudze Teams.

Łączenie aplikacji Azure Repos z repozytoriami

  1. Po zainstalowaniu aplikacji w zespole wprowadź następujący tekst w polu odpowiedzi: @azure repos signin

    Jeśli twoje usługi Microsoft Teams i Azure Boards znajdują się w różnych dzierżawach, wybierz pozycję Zaloguj się przy użyciu innej poczty e-mail.

    Zrzut ekranu przedstawiający wpis logowania usługi Teams dla usługi Azure Repos.

    Zrzut ekranu przedstawiający odpowiedź potwierdzającą zakończenie logowania.

  2. Aby monitorować wszystkie repozytoria Git w projekcie, wprowadź @azure repos subscribe [project url] do kanału. Pamiętaj, aby dodać adres URL projektu. Adres URL projektu może dotyczyć dowolnej strony w projekcie (z wyjątkiem adresów URL repozytoriów).

    Możesz również monitorować określone repozytorium przy użyciu: @azure repos subscribe [repo url].

    Adres URL repozytorium może być adresem dowolnej strony w repozytorium, która ma nazwę repozytorium, na przykład @azure repos subscribe https://dev.azure.com/myorg/myproject/_git/myrepo, lub repozytoria TFVC: @azure repos subscribe https://dev.azure.com/myorg/myproject/_versionControl.

  3. Polecenie subscribe spowoduje rozpoczęcie pracy z domyślną subskrypcją. W przypadku repozytoriów Git kanał jest subskrybowany do utworzonego zdarzenia żądania ściągnięcia (z gałęzią docelową = main). W przypadku repozytoriów TFVC kanał ma subskrybowane zdarzenie Zaewidencjonowano kod.

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

Zarządzanie subskrypcjami

Aby wyświetlić, dodać i usunąć subskrypcje dla kanału, wprowadź następujący tekst: @azure repos subscriptions.

Zostanie wyświetlona lista wszystkich bieżących subskrypcji dla kanału i możesz dodać nowe subskrypcje lub usunąć istniejące. Dostosuj powiadomienia przy użyciu różnych filtrów, jak opisano w poniższej sekcji.

Uwaga / Notatka

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

Wyświetlanie subskrypcji

Użyj filtrów, aby otrzymywać tylko żądane powiadomienia

Gdy subskrybujesz repozytorium z @azure repos subscribe, zostanie utworzona domyślna subskrypcja bez filtrów. Często użytkownicy muszą dostosować te subskrypcje, aby otrzymywać powiadomienia tylko po spełnieniu określonych warunków. Na poniższych zrzutach ekranu przedstawiono przykład konfigurowania powiadomień, gdy nasz zespół jest na liście recenzentów PR.

  1. Wprowadź następujący tekst w kanale: @azure repos subscriptions.

  2. Jeśli na liście subskrypcji istnieje subskrypcja, której nie chcesz lub której chcesz zmodyfikować, wybierz pozycję Usuń , aby ją usunąć.

  3. Wybierz przycisk Dodaj subskrypcję.

  4. Wybierz typ zdarzenia, a następnie wybierz pozycję Dalej.

    Zrzut ekranu przedstawiający wybór typu zdarzenia.

  5. Wybierz repozytorium, a następnie wybierz pozycję Dalej.

    Zrzut ekranu przedstawiający wybór repozytorium.

  6. Wybierz odpowiednie filtry, aby dostosować subskrypcję, a następnie wybierz pozycję Prześlij.

    Zrzut ekranu przedstawiający wybrane filtry.

Uwaga / Notatka

  • Wszystkie filtry są zwykle listami rozwijanymi. Jeśli jednak lista rozwijana ma więcej niż 100 elementów, musisz ręcznie wprowadzić wartości.
  • W przypadku zdarzenia TFVC Kod zaewidencjonowany w filtr Pod ścieżką musi być w formacie $/myproject/path.

Wyszukiwanie i udostępnianie informacji o żądaniu ściągnięcia przy użyciu rozszerzenia compose

Aby ułatwić użytkownikom wyszukiwanie i udostępnianie informacji o pull requestach, aplikacja Azure Repos dla usługi Microsoft Teams obsługuje rozszerzenie do tworzenia. Żądania ściągnięcia można wyszukiwać według identyfikatora lub nazwy. Aby rozszerzenie działało, zaloguj się do projektu Azure Repos, wprowadzając @azure repos signin lub logując się bezpośrednio do rozszerzenia kompozycyjnego.

Zrzut ekranu przedstawiający rozszerzenie redagowania.

Podgląd adresów URL pull requestów

Po wklejeniu adresu URL żądania pull, podgląd zostanie wyświetlony jak na poniższej ilustracji, co pomaga w utrzymaniu kontekstu i precyzyjności rozmów dotyczących żądań pull. Zaloguj się, a następnie możesz wyświetlić podgląd adresów URL we wszystkich kanałach w zespole.

Zrzut ekranu przedstawiający rozwinięcie adresu URL.

Usuwanie subskrypcji i repozytoriów z kanału

Aby usunąć wszystkie subskrypcje powiązane z dowolnym repozytorium w projekcie i usunąć repozytoria z kanału, wprowadź następujący tekst w aplikacji Teams: @azure repos unsubscribe all [project url]. Pamiętaj, aby wprowadzić adres URL projektu. To zadanie mogą wykonywać tylko administratorzy projektów.

Powiadomienia wątkowe

Aby połączyć zestaw powiązanych powiadomień i zmniejszyć ilość miejsca zajmowanego przez powiadomienia w kanale, powiadomienia są tworzone w wątki. Wszystkie powiadomienia powiązane z danym pull requestem są ze sobą połączone.

Kompaktowy widok powiadomień wątkowychZrzut ekranu przedstawiający kompaktowy widok powiadomień wątkowych.

Rozszerzony widok powiadomień wątkowychZrzut ekranu przedstawiający rozszerzony widok powiadomień wątkowych.

Referencja poleceń

W poniższej tabeli wymieniono wszystkie azure repos polecenia, których można użyć w kanale usługi Teams.

Command Funkcjonalność
@azure repos subscribe [repo url/ project url] Subskrybowanie repozytorium lub wszystkich repozytoriów w projekcie w celu otrzymywania powiadomień
@azure repos subscriptions Dodawanie lub usuwanie subskrypcji dla tego kanału
@azure repos signin Zaloguj się do organizacji usługi Azure Repos
@azure repos signout Wyloguj się z organizacji usługi Azure Repos
@azure repos feedback Zgłaszanie problemu lub sugerowanie funkcji
@azure repos unsubscribe all [project url] Usuwanie wszystkich repozytoriów (należących do projektu) i skojarzonych z nimi subskrypcji z kanału

Obsługa wielu lokatorów

Jeśli używasz innej poczty e-mail lub dzierżawy dla Microsoft Teams i Azure DevOps, wykonaj następujące kroki, aby się zalogować w zależności od scenariusza użycia.

Przypadek użycia Adres e-mail i tenant usługi Microsoft Teams Identyfikator poczty e-mail i dzierżawa usługi Azure DevOps Steps
1 email1@abc.com (klient 1) email1@abc.com (klient 1) Wybierz Zaloguj.
2 email1@abc.com (klient 1) email1@abc.com (najemca 2) Zaloguj się do usługi Azure DevOps. W tej samej przeglądarce otwórz nową kartę i przejdź do https://teams.microsoft.com/. Uruchom polecenie logowania i wybierz pozycję Zaloguj.
3 email1@abc.com (klient 1) email2@pqr.com (najemca 2) Wybierz pozycję Zaloguj się przy użyciu innego adresu e-mail, a następnie w selektorze identyfikatorów poczty e-mail użyj adresu e-mail2, aby zalogować się do usługi Azure DevOps.
4 email1@abc.com (klient 1) email2@pqr.com (niedomyślna dzierżawa 3) Ten scenariusz nie jest obsługiwany.

Troubleshoot

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

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 przy użyciu przeglądarki.

Otwórz w prywatnym oknie lub okno przeglądarki incognito, przejdź do https://aex.dev.azure.com/me 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ę i zaloguj się do witryny https://teams.microsoft.com/. Uruchom polecenie @Azure Repos signout, a następnie @Azure Repos signin w kanale, w którym zainstalowano aplikację Azure Repos dla Microsoft Teams.

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