Używanie usługi Azure Pipelines z usługą Slack

Azure DevOps Services

Aplikacja Azure Pipelines dla usługi Slack umożliwia użytkownikom usługi Slack łatwe śledzenie zdarzeń występujących w potokach. Aplikacja umożliwia użytkownikom ustanawianie i nadzorowanie subskrypcji dla różnych zdarzeń potoku, takich jak kompilacje, wydania, oczekujące zatwierdzenia i inne. Powiadomienia dotyczące tych zdarzeń są następnie dostarczane bezpośrednio do kanałów usługi Slack użytkowników

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

• W usłudze Slack musisz mieć uprawnienia do instalowania aplikacji w obszarze roboczym usługi Slack.
• W przypadku usługi Azure DevOps musisz znajdować się w grupie project collection Administracja istrators lub Project Administracja istrators, aby skonfigurować subskrypcję usługi Slack.

Instalowanie aplikacji Usługi Azure Pipelines

Przejdź do aplikacji Azure Pipelines Slack, aby zainstalować aplikację Azure Pipelines w obszarze roboczym usługi Slack. Po dodaniu zobaczysz komunikat powitalny z aplikacji, jak pokazano poniżej. Użyj uchwytu /azpipelines , aby rozpocząć interakcję z aplikacją.

Połączenie do potoku

Po zainstalowaniu aplikacji w obszarze roboczym usługi Slack możesz połączyć aplikację z dowolnym potokiem, który chcesz monitorować. Przed uruchomieniem jakichkolwiek poleceń zostanie wyświetlony monit o uwierzytelnienie w usłudze Azure Pipelines.

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

/azpipelines subscribe [project url]

Adres URL projektu może łączyć się z dowolną stroną w projekcie (z wyjątkiem adresów URL potoków). Na przykład: /azpipelines subskrybuj https://dev.azure.com/myorg/myproject/

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

/azpipelines subscribe [pipeline url]

Adres URL potoku może łączyć się z dowolną stroną w potoku, która zawiera definitionId adres URL lub .buildId/releaseId Na przykład: /azpipelines subskrybuj , lub: /azpipelines subskrybuj https://dev.azure.com/myorg/myproject/_build?definitionId=123https://dev.azure.com/myorg/myproject/_release?definitionId=123& view=mine&_a=releases

Polecenie subskrypcji domyślnie rozpoczyna pracę z kilkoma subskrypcjami. Poniżej przedstawiono domyślne powiadomienia włączone dla następującego typu potoku:

Potoki kompilacji	Potoki wydania	Potoki YAML
Powiadomienie o ukończonej kompilacji	Rozpoczęto wdrażanie wydania, Ukończono wdrożenie wydania i Oczekujące powiadomienia dotyczące zatwierdzenia wdrożenia wydania	Stan etapu uruchamiania został zmieniony i Etap uruchamiania oczekujący na powiadomienia o zatwierdzeniu

Zarządzanie subskrypcjami

Aby zarządzać subskrypcjami kanału, użyj następującego polecenia: /azpipelines subscriptions

To polecenie wyświetla listę wszystkich bieżących subskrypcji dla kanału i umożliwia dodawanie lub usuwanie subskrypcji.

Uwaga

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

Dostosowywanie subskrypcji

Domyślnie podczas subskrybowania potoku generowanych jest kilka subskrypcji, które nie mają zastosowanych filtrów. Jednak użytkownicy często chcą personalizować te subskrypcje zgodnie z ich preferencjami. Na przykład użytkownicy mogą chcieć otrzymywać powiadomienia tylko dla kompilacji, które zakończyły się niepowodzeniem lub gdy wdrożenia są wprowadzane do środowiska produkcyjnego. Aplikacja Azure Pipelines oferuje opcję stosowania filtrów, umożliwiając użytkownikom dostosowywanie komunikatów odbieranych w kanale. Aby dostosować subskrypcję:

1. Uruchom polecenie , /azpipelines subscriptions aby wyświetlić listę wszystkich subskrypcji.

2. Wybierz pozycję Dodaj subskrypcję.

3. Wybierz zdarzenie, do którego chcesz zasubskrybować, a następnie wybierz żądaną konfigurację.

4. Wybierz Zapisz, gdy skończysz.

Przykład: pobieranie powiadomień tylko dla kompilacji, które zakończyły się niepowodzeniem

Zatwierdzanie wdrożeń

Wdrożenia można zatwierdzać z poziomu kanału usługi Slack bez przechodzenia do portalu usługi Azure Pipelines, subskrybując powiadomienia oczekujące na zatwierdzenie wdrożenia wydania (wersje klasyczne) lub Etap uruchamiania oczekujący na powiadomienia o zatwierdzeniu (potoki YAML). Obie subskrypcje są tworzone domyślnie podczas subskrybowania potoku.

Aplikacja Azure Pipelines dla usługi Slack umożliwia obsługę wszystkich scenariuszy sprawdzania i zatwierdzania dostępnych w portalu usługi Azure Pipelines. Należą do nich pojedyncze osoby zatwierdzające, wiele osób zatwierdzających i zatwierdzanie oparte na zespole. Istnieje możliwość zatwierdzenia żądań indywidualnie lub w imieniu zespołu.

Usuń wszystkie subskrypcje

Aby usunąć swój kanał, możesz użyć następujących poleceń, aby anulować subskrypcję wszystkich potoków w projekcie. Na przykład: /azpipelines anuluj wszystkie https://dev.azure.com/myorg/myproject.

/azpipelines unsubscribe all [project url]

Ważne

To polecenie można wykonywać tylko przez administratorów projektu.

Dokumentacja poleceń

Oto wszystkie polecenia obsługiwane przez aplikację Azure Pipelines dla usługi Slack:

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

Powiadomienia w kanałach prywatnych

Aplikacja Azure Pipelines może również pomóc w monitorze aktywności potoków w kanałach prywatnych. Musisz zaprosić bota do kanału prywatnego przy użyciu polecenia /invite @azpipelines. Po dodaniu bota możesz skonfigurować i kontrolować powiadomienia w taki sam sposób, jak w przypadku kanału publicznego.

Uwaga

• Obecnie możesz użyć aplikacji Azure Pipelines dla usługi Slack tylko z projektem hostowanym w usługach Azure DevOps Services.
• Użytkownik musi być administratorem projektu zawierającego potok, aby skonfigurować subskrypcje
• Powiadomienia nie są obecnie obsługiwane wewnątrz komunikatów bezpośrednich
• Zatwierdzenia wdrożenia, które mają zastosowaną zasadę "Zmiana tożsamości osoby zatwierdzającej przed zakończeniem zatwierdzania", nie są obsługiwane
• Aby otrzymywać powiadomienia dla organizacji w usłudze Azure DevOps (organizacja Ustawienia — zabezpieczenia —>> zasady) należy włączyć dostęp do aplikacji innych firm za pośrednictwem protokołu OAuth.

Rozwiązywanie problemów

Jeśli podczas korzystania z aplikacji Azure Pipelines app for Slack występują następujące błędy, postępuj zgodnie z procedurami w tej sekcji.

Niestety, wystąpił błąd. Spróbuj ponownie

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

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

Wyloguj się z usługi Azure DevOps, przechodząc do następującego adresu URL: https://aka.ms/VsSignout.

Otwórz okno przeglądarki private/incognito i przejdź do https://aex.dev.azure.com/me witryny i zaloguj się. Wybierz katalog zawierający organizację, w której znajduje się potok, do którego chcesz zasubskrybować.

Korzystając z tej samej przeglądarki, otwórz nową kartę i przejdź do https://slack.comstrony . Zaloguj się do obszaru roboczego przy użyciu klienta internetowego, a następnie uruchom /azpipelines signout polecenie , a następnie /azpipelines signinpolecenie .

Sign in Wybierz przycisk i nastąpi przekierowanie do strony zgody, jak pokazano w poniższym przykładzie. Sprawdź, czy katalog wyświetlany obok adresu e-mail jest zgodny z katalogem wybranym w poprzednim kroku. Wybierz pozycję Akceptuj , aby ukończyć proces logowania.

Powiązane artykuły

• Usługa Azure Boards z usługą Slack
• Usługa Azure Repos z usługą Slack
• Tworzenie elementu zaczepienia usługi dla usługi Azure DevOps przy użyciu usługi Slack