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

  • Artykuł

Azure DevOps Services

Aplikacja Azure Pipelines dla usługi Microsoft Teams umożliwia monitorowanie zdarzeń dla potoków. Możesz skonfigurować i otrzymywać powiadomienia w kanale usługi Teams dla wydań, oczekujących zatwierdzeń, ukończonych kompilacji itd. Możesz również zatwierdzać wydania z poziomu kanału usługi Teams.

Uwaga

Ta funkcja jest dostępna tylko w usługach Azure DevOps Services. Zazwyczaj nowe funkcje są najpierw wprowadzane w usłudze w chmurze, a następnie udostępniane lokalnie w następnej wersji głównej lub aktualizacji serwera Azure DevOps Server. Aby dowiedzieć się więcej, zobacz Oś czasu funkcji usługi Azure DevOps.

Wymagania wstępne

  • Musisz mieć projekt usługi Azure DevOps. Aby uzyskać więcej informacji, zobacz Tworzenie projektu.
  • Aby skonfigurować subskrypcje potoków, musisz być Administracja istratorem projektu.

Konfigurowanie aplikacji Usługi Azure Pipelines

  1. W usłudze Microsoft Teams przejdź do sklepu Aplikacje, wyszukaj pozycję Azure Pipelines, a następnie wybierz pozycję Azure Pipelines.

    Zrzut ekranu przedstawiający wybieranie przycisku Aplikacje, a następnie przycisk Azure Pipelines.

  2. Wybierz strzałkę listy rozwijanej Otwórz , a następnie wybierz pozycję Dodaj do zespołu.

    Zrzut ekranu przedstawiający wybieranie przycisku Otwórz, a następnie przycisk Dodaj do zespołu.

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

    Wybranie przycisku Skonfiguruj bota.

  4. W okienku konwersacji usługi Teams wprowadź .@azurePipelines signin

  5. Wybierz pozycję Zaloguj się i ukończ uwierzytelnianie w usłudze Azure Pipelines.

Korzystanie z poleceń

Użyj następujących poleceń, aby monitorować wszystkie potoki w projekcie lub tylko określone potoki.

  • Monitoruj wszystkie potoki w projekcie. Adres URL może dotyczyć dowolnej strony w projekcie, z wyjątkiem adresów URL potoków. Na przykład @azure pipelines subscribe https://dev.azure.com/myorg/myproject/.

    @azure pipelines subscribe [project url]

  • Monitorowanie określonego potoku: adres URL potoku może znajdować się na dowolnej stronie w potoku, która ma definitionId adres URL lub buildId/releaseId znajduje się w adresie URL. Na przykład @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123.

    @azure pipelines subscribe [pipeline url]

    Innym przykładem potoku wydania subskrybowanego wdrożenia wydania, ukończonego wdrożenia wydania i oczekujących powiadomień o zatwierdzeniu wdrożenia wydania jest @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases.

Uwaga

  • Nie obsługujemy zatwierdzeń wdrożeń, które zastosowały tożsamość osoby zatwierdzającej przed ukończeniem zasad zatwierdzania .
  • Włącz dostęp do aplikacji innej firmy za pośrednictwem protokołu OAuth, aby otrzymywać powiadomienia dla organizacji w usłudze Azure DevOps.

Zarządzanie subskrypcjami

Po zasubskrybowaniu potoku kilka subskrypcji zostanie utworzonych domyślnie bez zastosowanych filtrów. Możesz dostosować te subskrypcje. Na przykład możesz otrzymywać powiadomienia tylko wtedy, gdy kompilacje kończą się niepowodzeniem lub gdy wdrożenia zostaną wypchnięte do środowiska produkcyjnego. Aplikacja Azure Pipelines obsługuje filtry, aby dostosować to, co widzisz w kanale. Aby zarządzać subskrypcjami, wykonaj następujące kroki.

  1. Uruchom polecenie @azure pipelines subscriptions.

  2. Wybierz pozycję Wyświetl wszystkie subskrypcje. Jeśli na liście subskrypcji nie ma subskrypcji, wybierz pozycję Usuń. Widok listy subskrypcji.

  3. Przewiń w dół i wybierz pozycję Dodaj subskrypcję.

  4. Wybierz wymagany potok i zdarzenie.

  5. Wybierz odpowiednie filtry, a następnie pozycję Zapisz.

    Przykład 1. Otrzymywanie powiadomień o nieudanych kompilacjach.

    Wizualizacja niepowodzeń kompilacji w usłudze Teams.

    Przykład 2. Otrzymywanie powiadomień tylko wtedy, gdy wdrożenia zostaną wypchnięte do środowiska produkcyjnego.

    Wizualizacja powiadomienia o niepowodzeniu.

    Uwaga

    • Zespoły Administracja istratorów nie mogą usuwać ani modyfikować subskrypcji utworzonych przez Administracja istratory programu Project.
    • Powiadomienia nie są obsługiwane wewnątrz czatu/wiadomości bezpośrednich.

Zatwierdzanie wdrożeń z kanału

Wdrożenia można zatwierdzać z poziomu kanału bez przechodzenia do portalu usługi Azure Pipelines. Zasubskrybuj powiadomienie o zatwierdzeniu wdrożenia wydania dla wersji klasycznych lub Etap uruchamiania oczekujący na powiadomienie o zatwierdzeniu potoków YAML. Obie te subskrypcje są tworzone domyślnie podczas subskrybowania potoku.

W aplikacji Teams zwróć uwagę na gotowość do zatwierdzenia.

Za każdym razem, gdy uruchomienie etapu oczekuje na zatwierdzenie, karta powiadomień z opcjami zatwierdzenia lub odrzucenia żądania zostanie wysłana w kanale. Osoby zatwierdzające mogą przejrzeć szczegóły żądania w powiadomieniu i podjąć odpowiednie działania. W poniższym przykładzie wdrożenie zostało zatwierdzone, a stan zatwierdzenia jest wyświetlany na karcie.

Karta przedstawiająca zatwierdzone wdrożenie.

Aplikacja Azure Pipelines obsługuje wszystkie scenariusze sprawdzania i zatwierdzania w portalu usługi Azure Pipelines. Żądania można zatwierdzać jako osoba indywidualna lub dla zespołu.

Wyszukiwanie i udostępnianie informacji o potoku przy użyciu rozszerzenia compose

Aby ułatwić użytkownikom wyszukiwanie i udostępnianie informacji o potokach, aplikacja Azure Pipelines dla usługi Microsoft Teams obsługuje rozszerzenie redagowania. Teraz możesz wyszukiwać potoki według identyfikatora potoku lub nazwy potoku. Aby rozszerzenie redagowania działało, użytkownicy muszą zalogować się do projektu usługi Azure Pipelines, którego interesują, uruchamiając @azure pipelines signin polecenie lub logując się bezpośrednio do rozszerzenia redagowania.

Utwórz rozszerzenie.

Podglądy adresów URL potoku

Po dodaniu adresu URL potoku do usługi Teams zostanie wyświetlony podgląd podobny do poniższych obrazów. Wersja zapoznawcza ułatwia aktualizowanie konwersacji związanych z potokiem. Możesz wybrać między kartami kompaktowymi i rozszerzonymi.

Przykład 1. Kompilacja adresu URL (wersja zapoznawcza)

Rozwikłanie adresu URL kompilacji.

Przykład 2. Wersja zapoznawcza adresu URL wydania

Rozwikłanie adresu URL wydania.

Po zalogowaniu ta funkcja działa dla wszystkich kanałów w zespole w usłudze Microsoft Teams.

Anulowanie subskrypcji kanału potoku

Użyj następującego polecenia, aby anulować subskrypcję wszystkich potoków w projekcie.

@azure pipelines unsubscribe all [project url]

Przykład: anulowanie subskrypcji wszystkich z adresem URL

@azure pipelines unsubscribe all https://dev.azure.com/myorg/myproject

To polecenie usuwa wszystkie subskrypcje powiązane z dowolnym potokiem w projekcie i usuwa potoki z kanału.

Ważne

To polecenie może uruchamiać tylko Administracja istratorzy programu Project.

Wszystkie powiadomienia połączone z konkretnym uruchomieniem potoku są połączone.

Przykład 1. Kompaktowy widok połączonych powiadomień.

Zwarty wątek

Przykład 2. Rozszerzony widok połączonych powiadomień.

Rozszerzony wątek

Używanie poleceń w aplikacji Azure Pipelines

Zobacz następujące polecenia obsługiwane przez aplikację Azure Pipelines:

Polecenie slash Funkcje
@azure potoki subskrybują [adres URL potoku/ adres URL projektu] Subskrybowanie potoku lub wszystkich potoków w projekcie w celu odbierania powiadomień
@azure subskrypcje potoków Dodawanie lub usuwanie subskrypcji dla tego kanału
@azure opinie dotyczące potoków Zgłaszanie problemu lub sugerowanie funkcji
@azure pomoc dotycząca potoków Uzyskiwanie pomocy dotyczącej poleceń ukośnika
@azure podpisywanie potoków Zaloguj się do konta usługi Azure Pipelines
@azure wylogowanie potoków Wyloguj się z konta usługi Azure Pipelines
@azure potoki anulują wszystkie [adres URL projektu] Usuwanie wszystkich potoków (należących do projektu) i skojarzonych z nimi subskrypcji z kanału

Połączenie wielu dzierżaw

Jeśli używasz innej poczty e-mail lub dzierżawy usług Microsoft Teams i Azure DevOps, wykonaj następujące kroki, aby zalogować się i nawiązać połączenie w zależności od przypadku użycia.

Przypadek użycia Identyfikator i dzierżawa poczty e-mail w usłudze Microsoft Teams Identyfikator poczty e-mail i dzierżawa w usłudze Azure DevOps Akcja logowania
1 email1@abc.com (dzierżawa 1) email1@abc.com (dzierżawa 1) Wybierz Zaloguj się
2 email1@abc.com (dzierżawa 1) email2@pqr.com (dzierżawa 2) — Zaloguj się do usługi Azure DevOps.
— W tej samej przeglądarce uruchom nową kartę i przejdź do strony https://teams.microsoft.com/.
- Uruchom sign in polecenie i wybierz pozycję Zaloguj.
3 email1@abc.com (dzierżawa 1) email2@pqr.com (dzierżawa 2) — Wybierz pozycję Zaloguj się przy użyciu innego adresu e-mail.
— W selektorze identyfikatorów poczty e-mail użyj adresu e-mail2, aby się zalogować.
100 email1@abc.com (dzierżawa 1) email2@pqr.com (dzierżawa innej niż domyślna 3) Obecnie nieobsługiwane.

Rozwiązywanie problemów

W tej samej przeglądarce uruchom nową kartę i zaloguj się do witryny https://teams.microsoft.com/. @Azure Pipelines signout Uruchom polecenie, a następnie uruchom @Azure Pipelines signin polecenie w kanale, w którym zainstalowano aplikację Azure Pipelines dla usługi Microsoft Teams.

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.

Zgoda na żądane uprawnienia aplikacji

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