Integrowanie usługi Azure Pipelines z usługą Microsoft Teams

Azure DevOps Services

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.

W tym artykule pokazano, jak używać aplikacji Azure Pipelines dla usługi Microsoft Teams do monitorowania zdarzeń potoku. Możesz skonfigurować i otrzymywać powiadomienia w kanale usługi Teams na potrzeby kompilacji, wydań i zatwierdzeń potoku. Osoby zatwierdzające mogą również zatwierdzać wydania z poziomu kanału usługi Teams.

Uwaga

Powiadomienia usługi Azure Pipelines nie są obsługiwane w czacie usługi Teams ani w wiadomościach bezpośrednich.

Wymagania wstępne

• Dostęp do zespołu w usłudze Microsoft Teams, w którym można dodać aplikację.
• Uprawnienia administratora projektu lub administratora kompilacji w projekcie usługi Azure DevOps. Aby uzyskać więcej informacji, zobacz Tworzenie projektu i Zasoby zabezpieczeń potoku.
• Dostęp do aplikacji innych firm za pośrednictwem protokołu OAuth włączonego w ustawieniach organizacyjnych usługi Azure DevOps.

Konfigurowanie aplikacji Usługi Azure Pipelines

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

   

2. Wybierz strzałkę listy rozwijanej obok pozycji Dodaj, a następnie wybierz pozycję Dodaj do zespołu.

   

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

   

Korzystanie z poleceń aplikacji usługi Azure Pipelines

Aplikacja Azure Pipelines Teams obsługuje następujące polecenia:

Polecenie slash	Funkcje
@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 adres URL potoku subskrypcji <potoku | adres URL projektu>	Subskrybuj potok lub wszystkie potoki w projekcie, aby otrzymywać powiadomienia.
@azure subskrypcje potoków	Wyświetlanie, dodawanie lub usuwanie subskrypcji dla tego kanału.
@azure potoki anulują wszystkie <adresy URL projektu>	Usuń wszystkie potoki należące do projektu i skojarzone z nimi subskrypcje z kanału.
@azure pomoc dotycząca potoków	Uzyskaj pomoc dotyczącą poleceń.
@azure opinie dotyczące potoków	Zgłoś problem lub zasugeruj funkcję.

Logowanie się do usługi Azure Pipelines

1. W okienku konwersacji usługi Teams wprowadź .@azurePipelines signin
2. Wybierz pozycję Zaloguj się i ukończ uwierzytelnianie w usłudze Azure Pipelines.

Subskrybowanie potoków

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

• Wszystkie potoki w projekcie: adres URL może dotyczyć projektu lub dowolnej strony w projekcie, z wyjątkiem potoku. Na przykład:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/
  

• Określony potok: adres URL potoku może dotyczyć dowolnej strony w potoku, który ma definitionId adres URL lub buildId/releaseId . Na przykład:

  @azure pipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  

Rozwijanie połączonych powiadomień

Wszystkie odpowiedzi dla określonego wpisu są połączone razem.

Aby rozwinąć wątek, wybierz zwarty link wątku.

Zarządzanie subskrypcjami

Po zasubskrybowaniu potoku kilka subskrypcji zostanie utworzonych domyślnie bez zastosowanych filtrów. Subskrypcje te obejmują zmianę stanu uruchamiania i etap uruchamiania oczekujący na zatwierdzenie potoków YAML oraz oczekiwanie na zatwierdzenie wdrożenia wydania dla wersji klasycznych. Możesz usunąć te subskrypcje lub dodać więcej subskrypcji.

Aplikacja Azure Pipelines obsługuje również filtry, aby dostosować to, co widzisz w kanale. 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.

Aby zarządzać subskrypcjami, wykonaj następujące kroki.

1. Aby wyświetlić listę wszystkich subskrypcji potoków, uruchom @azure pipelines subscriptions polecenie .

   

2. Aby usunąć subskrypcję, wybierz pozycję Wyświetl wszystkie subskrypcje. Wybierz pozycję Usuń w ramach dowolnej subskrypcji, której nie chcesz, a następnie wybierz przycisk OK.

3. Aby dodać subskrypcję, wybierz pozycję Dodaj subskrypcję.

4. Wybierz zdarzenie i potok, do którego chcesz zasubskrybować, a następnie wybierz pozycję Dalej.

5. Wybierz dowolne filtry etapu i środowiska , wybierz pozycję Prześlij, a następnie wybierz przycisk OK.

   Na przykład następująca subskrypcja zawiera powiadomienia dotyczące etapu _default tylko wtedy, gdy stan Ukończono to Niepowodzenie.

   

Uwaga

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

Zobacz powiadomienia o zatwierdzeniach

Aby wyświetlić powiadomienia o zatwierdzeniach, upewnij się, że subskrybujesz etap Uruchamiania oczekujący na powiadomienie o zatwierdzeniu potoków YAML lub oczekujące powiadomienie o zatwierdzeniach wdrożenia wydania dla wersji klasycznych. Te subskrypcje są tworzone domyślnie podczas subskrybowania potoku.

Jeśli subskrybujesz powiadomienie o zakończeniu zatwierdzania etapu uruchamiania, możesz również zobaczyć, kiedy etap zostanie zatwierdzony.

Uwaga

Nie można subskrybować zatwierdzeń wdrożenia, które mają tożsamość ponownej weryfikacji osoby zatwierdzającej przed ukończeniem zastosowanych zasad zatwierdzania .

Zatwierdzanie z kanału

Jeśli jesteś osoba zatwierdzającą, możesz zatwierdzić wdrożenia z poziomu kanału usługi Teams. Aplikacja Azure Pipelines obsługuje wszystkie scenariusze sprawdzania i zatwierdzania usługi Azure Pipelines. Żądania można zatwierdzać jako osoba indywidualna lub dla zespołu.

Za każdym razem, gdy uruchomienie etapu oczekuje na zatwierdzenie, aplikacja publikuje kartę powiadomień z opcjami Zatwierdź lub Odrzuć żądanie w kanale. Możesz przejrzeć szczegóły żądania w powiadomieniu i podjąć odpowiednie działania.

Odpowiedź jest wysyłana do aplikacji.

Jeśli zasubskrybujesz powiadomienia o zakończeniu zatwierdzania etapu uruchamiania, możesz również zobaczyć, kiedy etap zostanie zatwierdzony.

Anulowanie subskrypcji kanału

Uruchom polecenie , unsubscribe aby usunąć wszystkie subskrypcje powiązane z dowolnym potokiem w projekcie i usunąć potoki z kanału. Na przykład:

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

Aby usunąć projekt i wszystkie subskrypcje z kanału, wybierz pozycję Kontynuuj.

Ważne

To polecenie mogą uruchamiać tylko administratorzy projektu.

Korzystanie z rozszerzenia redagowania

Aby ułatwić wyszukiwanie i udostępnianie informacji o potokach, aplikacja Azure Pipelines dla usługi Teams obsługuje rozszerzenie redagowania w komunikatach. Za pomocą rozszerzenia można wyszukiwać potoki w projekcie według identyfikatora potoku lub nazwy potoku.

Aby użyć rozszerzenia, musisz zalogować się do projektu usługi Azure Pipelines w kanale usługi Teams. + Wybierz symbol w polu komunikatu, wybierz pozycję Azure Pipelines, a następnie wyszukaj potok lub wydanie.

Podgląd adresów URL potoku

Gdy używasz rozszerzenia redagowania w celu dodania adresu URL potoku do komunikatu usługi Teams, zostanie wyświetlony podgląd podobny do poniższych obrazów. Wersja zapoznawcza ułatwia aktualizowanie konwersacji związanych z potokiem.

W poniższym przykładzie przedstawiono podgląd adresu URL wydania:

Łączenie wielu dzierżaw

Jeśli używasz różnych wiadomości e-mail lub dzierżaw dla usług Microsoft Teams i Azure DevOps, wykonaj następujące kroki, aby zalogować się i nawiązać połączenie na podstawie ustawień.

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

Rozwiązywanie problemów z uwierzytelnianiem

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.

Wybierz przycisk Zaloguj się i ukończ proces logowania. Upewnij się, że wyświetlony katalog jest taki sam jak wybrany w poprzednim kroku.

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

Powiązane artykuły

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