Konfigurowanie potoków do obsługi śledzenia pracy

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Aby obsługiwać integrację i możliwość śledzenia w usługach Azure DevOps Services za pomocą potoków, można skonfigurować kilka opcji. Możesz zgłaszać stan potoku, kopiować składnię znaczków stanu i konfigurować automatyczne łączenie elementów roboczych z kompilacjami i wydaniami.

Obsługiwane funkcje integracji potoku i śledzenia pracy

Dostępnych jest kilka funkcji, które zapewniają obsługę kompleksowej możliwości śledzenia podczas przechodzenia scenariuszów i funkcji użytkownika przez cykl rozwoju. Podobnie jak w przypadku usługi Azure Repos, można połączyć elementy robocze z obiektami potoku z następującymi typami linków: Kompilacja, Zintegrowana w kompilacji i Zintegrowana w wersji. Link Zintegrowane w środowisku wydania można utworzyć tylko przez włączenie opcji Stan wydania raportu na tablice w potokach wydania klasycznego.

Poniższa tabela zawiera podsumowanie punktów integracji między usługą Azure Boards i usługą Azure Pipelines. Opcje i kroki konfiguracji różnią się w zależności od tego, czy konfigurujesz potok YAML, czy klasyczny oraz wersję usługi Azure DevOps. Większość opcji jest obsługiwana w przypadku potoków uruchamianych w repozytorium Git usługi Azure Repos, chyba że określono inaczej.

Funkcja

Opis

Obsługiwane wersje

---

Ręczne łączenie elementów roboczych z kompilacjami

Możesz połączyć się z elementem roboczym, aby utworzyć kompilacje w ramach tego samego projektu lub innych projektów w organizacji. Aby uzyskać więcej informacji, zobacz Łączenie z elementami roboczymi z innych obiektów.

Wszystkie wersje

---

Wyświetlanie kompilacji połączonych z elementem roboczym

Wszystkie kompilacje połączone z elementem roboczym, zarówno ręcznie, jak i automatycznie połączone, można wyświetlić na karcie Linki. Aby uzyskać więcej informacji, zobacz Łączenie z elementami roboczymi z innych obiektów, Wyświetlanie listy połączonych obiektów.

Wszystkie wersje

---

Automatyczne łączenie elementów roboczych z kompilacjami

Wymagane do wypełnienia kontrolki Programowanie za pomocą linków zintegrowanych w kompilacji . Elementy robocze lub zatwierdzenia, które są częścią wydania, są obliczane z wersji artefaktów. Na przykład każda kompilacja w usłudze Azure Pipelines jest skojarzona z zestawem elementów roboczych i zatwierdzeń. Aby uzyskać więcej informacji, zobacz Automatyczne łączenie elementów roboczych w dalszej części tego artykułu.

YAML, Azure DevOps Server 2020 i nowsze

---

Automatyczne łączenie elementów roboczych z wydaniami i zgłaszanie stanu wdrożenia do elementu roboczego (tylko wersja klasyczna)

Wymagane do wypełnienia kontrolki Wdrożenie w formularzu elementu roboczego za pomocą linków zintegrowanych w etapie wydania. Aby uzyskać więcej informacji, zobacz Raport stan wdrożenia do tablic w dalszej części tego artykułu.

Usługa Azure DevOps Server 2020 lub nowsza

---

Wyświetlanie listy elementów roboczych połączonych z kompilacją lub wydaniem

Przejrzyj i otwórz elementy robocze zawarte w kompilacji lub wydaniu.

YAML, Azure DevOps Server 2020 i nowsze

---

Tworzenie elementu roboczego w przypadku niepowodzenia (wersja klasyczna)

Automatycznie utwórz element roboczy, gdy kompilacja zakończy się niepowodzeniem i opcjonalnie ustaw wartości pól elementu roboczego. Aby uzyskać więcej informacji, zobacz Tworzenie elementu roboczego w przypadku niepowodzenia w dalszej części tego artykułu.

2018 i nowsze wersje

---

Zadanie Wykonywanie zapytań o elementy robocze, upewnij się, że liczba pasujących elementów roboczych zwróconych z zapytania mieści się w progu.

Użyj tego zadania, aby upewnić się, że liczba pasujących elementów zwracanych przez zapytanie elementu roboczego mieści się w skonfigurowanych progach. Aby uzyskać więcej informacji, zobacz Query Work Items task (Wykonywanie zapytań o elementy robocze), Control deployments with gates and approvals (Kontrolowanie wdrożeń za pomocą bram i zatwierdzeń).

Azure DevOps Server 2020 i nowsze wersje

---

Wymagania wstępne

• Aby skonfigurować opcje integracji dla klasycznego potoku wydania, musisz mieć uprawnienia do edytowania wydania.
• Aby połączyć elementy robocze z zatwierdzeniami i żądaniami ściągnięcia, musisz mieć uprawnienia Edytuj elementy robocze w tym węźle ustawione na wartość Zezwalaj na ścieżkę obszaru przypisaną do elementu roboczego. Domyślnie grupa Współautorzy ma ten zestaw uprawnień.
• Aby wyświetlić elementy robocze, musisz mieć uprawnienia Wyświetl elementy robocze w tym węźle ustawione na zezwalanie na ścieżkę obszaru przypisaną do elementu roboczego.

Otwieranie ustawień potoku, opcji kompilacji lub opcji integracji

YAML

Otwórz ustawienia potoku

W przypadku potoków wydania zdefiniowanych w języku YAML należy skonfigurować integrację za pomocą okna dialogowego Ustawienia potoku.

1. Otwórz potok, wybierz pozycję Więcej akcji, a następnie wybierz pozycję Ustawienia.

   

   Zostanie wyświetlone okno dialogowe Ustawienia potoku. Aby uzyskać więcej informacji na temat automatycznego łączenia, zobacz Automatyczne łączenie elementów roboczych w dalszej części tego artykułu.

   

Kompilacja klasyczna

Właściwości kompilacji

Otwórz potok kompilacji, wybierz opcję edytowania potoku, a następnie wybierz kartę Opcje .

Zostanie wyświetlona strona Właściwości kompilacji.

Aby uzyskać więcej informacji na temat każdego ustawienia, użyj jednego z następujących linków:

• Format numeru kompilacji
• Automatyczne łączenie elementów roboczych
• Tworzenie elementu roboczego w przypadku niepowodzenia
• Znaczek Stan

Wersja klasyczna

Opcje integracji wydania

W przypadku potoków wydania klasycznego otwórz pozycję Wydania potoków>, wybierz opcję edycji potoku, a następnie wybierz pozycję Opcje, a następnie pozycję Integracje.

Aby uzyskać więcej informacji na temat każdego ustawienia, użyj jednego z następujących linków:

• Zgłaszanie stanu wdrożenia na hoście repozytorium
• Zgłaszanie stanu wdrożenia do pracy
• Zgłaszanie stanu wdrożenia do tablic
• Zgłaszanie stanu wdrożenia w usłudze Jira
• Znaczek Włącz stan wdrożenia

Automatyczne łączenie elementów roboczych z kompilacjami lub wydaniami

Włączając automatyczne łączenie, można śledzić kompilacje lub wydania, które zostały włączone, bez konieczności ręcznego wyszukiwania za pośrednictwem dużego zestawu kompilacji lub wydań. Każda pomyślna kompilacja skojarzona z elementem roboczym jest automatycznie wyświetlana w kontrolce Programowanie formularza elementu roboczego. Każdy etap wydania skojarzony z elementem roboczym jest automatycznie wyświetlany w kontrolce Wdrażanie formularza elementu roboczego.

YAML

1. Otwórz ustawienia potoku zgodnie z opisem w temacie Otwórz ustawienia potoku.

2. Włącz opcję Automatycznie połącz nową pracę w tej kompilacji.

   

   Po włączeniu funkcji Zintegrowane w linkach kompilacji są generowane dla wszystkich elementów roboczych połączonych z wybranym żądaniem ściągnięcia z każdym uruchomieniem wydania.

Kompilacja klasyczna

1. Otwórz właściwości kompilacji potoku zgodnie z opisem we właściwościach kompilacji.

2. Włącz automatyczne łączenie elementów roboczych uwzględnionych w tym przebiegu. Dodaj gałęzie do uwzględnienia lub wykluczenia.
   

   Po włączeniu funkcji Zintegrowane w kompilacji są generowane dla wszystkich elementów roboczych połączonych z wybranymi gałęziami w każdym przebiegu.

   Aby wyświetlić listę elementów roboczych połączonych z kompilacją, wybierz link Powiązane na stronie Podsumowanie.

   

3. Zapisz potok.

Wersja klasyczna

Przed wybraniem opcji integracji skonfiguruj etapy wydania zgodnie z opisem w artykule Definiowanie potoku ciągłego wdrażania wieloetapowego (CD).

1. Otwórz opcje>Integracji dla potoku wydania zgodnie z opisem w temacie Opcje integracji wydania.

2. Zaznacz pole wyboru Stan wdrożenia raportu do tablic. Zamapuj typ wdrożenia na każdy etap lub pozostaw pole Niezamapowane. Wybierz tę opcję, jeśli chcesz utworzyć łącza do wszystkich elementów roboczych reprezentujących skojarzone zmiany w źródle po zakończeniu wydania. Ta opcja musi być włączona, aby kontrolka wdrażania formularza elementu roboczego działała.

   

   Aby wyświetlić listę elementów roboczych połączonych z wydaniem, wybierz pozycję Zwolnij (stary widok) w obszarze Więcej poleceń, a następnie wybierz kartę Elementy robocze.

   

3. Zapisz potok.

Weryfikowanie integracji

Aby sprawdzić, czy integracja działa, wykonaj następujące kroki:

1. Połącz co najmniej jeden element roboczy z zatwierdzeniem lub żądaniem ściągnięcia w repozytorium Git usługi Azure Repos. Aby uzyskać więcej informacji, zobacz:

   • Wspieranie programowania w usłudze Git na podstawie elementu roboczego
   • Łączenie z elementami roboczymi z innych obiektów

2. Uruchom potok.

3. Otwórz jeden z połączonych elementów roboczych i wyświetl kontrolkę Wdrażanie . Jak pokazano na poniższej ilustracji, kontrolka Wdrażanie przedstawia informacje o wersji dla dwóch etapów wydania tych elementów roboczych połączonych z zatwierdzeniem lub żądaniem ściągnięcia usługi Git dla potoku wydania skonfigurowanego do integracji z usługą Azure Boards.

Jakie elementy robocze są zawarte w automatycznym łączeniu?

Podczas tworzenia oprogramowania można połączyć elementy robocze podczas tworzenia gałęzi, zatwierdzenia lub żądania ściągnięcia. Możesz też zainicjować gałąź, zatwierdzenie lub żądanie ściągnięcia z elementu roboczego, automatycznie łącząc te obiekty zgodnie z opisem w temacie Drive Git development from a work item (Tworzenie dysku git z elementu roboczego). Na przykład w tym miejscu utworzymy nową gałąź z artykułu użytkownika Formularza anulowania zamówienia.

Po automatycznym łączeniu elementów roboczych do kompilacji są wykonywane następujące obliczenia:

• W przypadku kompilacji po raz pierwszy:

  • Zidentyfikuj wszystkie elementy robocze połączone z gałęzią, zatwierdzeniami i żądaniami ściągnięcia skojarzonymi z kompilacją.

• W przypadku kolejnych kompilacji:

  • Zidentyfikuj wszystkie elementy robocze skojarzone z aktualnie utworzonym zatwierdzeniem (C1).
  • Zidentyfikuj wszystkie elementy robocze skojarzone z zatwierdzeniem (C2) ostatniej pomyślnej kompilacji tej samej gałęzi źródłowej.
  • Zidentyfikuj wszystkie elementy robocze skojarzone z zatwierdzeniami między C1 i C2 w drzewie zatwierdzeń.

Tworzenie elementu roboczego w przypadku niepowodzenia kompilacji (wersja klasyczna)

Jeśli potok kompilacji zakończy się niepowodzeniem, możesz automatycznie utworzyć element roboczy w celu śledzenia rozwiązania problemu. Możesz określić typ elementu roboczego i ustawić opcje, aby automatycznie przypisać go do osoby żądającej lub innych pól. Osoba żądająca odpowiada osobie, która wyzwoliła kompilację.

Napiwek

Opcja Tworzenia elementu roboczego w przypadku awarii jest obsługiwana tylko w przypadku potoków klasycznych. Aby to osiągnąć za pomocą potoku YAML, możesz użyć rozszerzenia witryny Marketplace, takiego jak niepowodzenie tworzenia usterki w wersji, lub zaimplementować go samodzielnie przy użyciu interfejsu wiersza polecenia platformy Azure lub wywołań interfejsu API REST.

1. Otwórz opcje kompilacji potoku zgodnie z opisem we właściwościach kompilacji.

2. Włącz opcję Utwórz element roboczy po niepowodzeniu i wybierz typ elementu roboczego do utworzenia. Opcjonalnie zaznacz pole wyboru Przypisz do osoby żądającej, aby ustawić pole Przypisz do i dodać pola do ustawienia w elemencie roboczym do utworzenia.

   Na przykład w tym miejscu wybieramy typ elementu roboczego Usterka i określamy pola Priorytet i Tagi oraz ich wartości.

   

3. Zapisz potok.

Aby dowiedzieć się, jak nazwa odwołania do pola, poszukaj go w indeksie pola Element roboczy. W przypadku pól niestandardowych dodanych za pośrednictwem dziedziczonego procesu usługa Azure DevOps przypisuje nazwę referencyjną na podstawie przyjaznej nazwy pola poprzedzonej prefiksem Niestandardowy. Można na przykład dodać pole o nazwie DevOps Triage. Nazwa odwołania to Custom.DevOpsTriage. W nazwie odwołania nie są dozwolone żadne spacje.

Znaczek Uzyskiwanie lub włączanie stanu

YAML

1. Otwórz potok Więcej akcji i wybierz wskaźnik Stan.

   

2. Wybierz gałąź i zakres zainteresowania, a następnie wybierz pozycję Kopiuj do schowka , aby skopiować obraz lub składnię języka Markdown.

   

Kompilacja klasyczna

1. Otwórz właściwości kompilacji potoku zgodnie z opisem we właściwościach kompilacji.

2. Wybierz pozycję Kopiuj do schowka , aby skopiować obraz lub składnię języka Markdown.

   

3. Zapisz potok.

Wersja klasyczna

Wybierz tę opcję, jeśli chcesz wyświetlić najnowszy wynik wdrożenia etapu w zewnętrznej witrynie internetowej.

1. Zaznacz pole wyboru Włącz stan wdrożenia. Następnie wybierz etapy, dla których chcesz wyświetlić wynik. Domyślnie wybierane są wszystkie etapy zdefiniowane dla wydania.

   

2. Wybierz pozycję Kopiuj do schowka , aby skopiować obraz lub składnię języka Markdown.

   

3. Zapisz potok.

Zgłaszanie stanu wdrożenia na hoście repozytorium (wersja klasyczna)

Gdy kod jest przechowywany w repozytorium Git usługi Azure Repos, możesz skonfigurować potok wydania, aby wyświetlić wskaźnik na stronach usługi Azure Repos. Wskaźnik wskazuje miejsce wdrożenia określonego zatwierdzenia i informację o tym, czy wdrożenie przechodzi, czy kończy się niepowodzeniem. Ta opcja zwiększa możliwość śledzenia z zatwierdzenia kodu do wdrożenia.

Stan wdrożenia jest wyświetlany w następujących sekcjach usługi Azure Repos:

• Pliki: wskazuje stan najnowszego wdrożenia dla wybranej gałęzi.
• Zatwierdzenia: wskazuje stan wdrożenia dla każdego zatwierdzenia (wymaga włączenia wyzwalacza ciągłej integracji (CD) dla wydania.
• Gałęzie: wskazuje stan najnowszego wdrożenia dla każdej gałęzi.

Jeśli zatwierdzenie zostanie wdrożone w wielu potokach wydania, z wieloma etapami, każdy z nich ma wpis w znaczek ze stanem wyświetlanym dla każdego etapu. Domyślnie podczas tworzenia potoku wydania stan wdrożenia jest publikowany dla wszystkich etapów. Można jednak selektywnie wybrać etapy, dla których stan wdrożenia powinien być wyświetlany na wskaźniku stanu (na przykład pokaż tylko etap produkcji). Członkowie zespołu mogą wybrać wskaźnik stanu, aby wyświetlić najnowszy stan wdrożenia dla każdego z wybranych etapów potoków wydania.

Zgłaszanie stanu wdrożenia w usłudze Jira (wersja klasyczna)

Uwzględnij problemy z programem Jira w elementach roboczych i utwórz linki do wszystkich problemów podczas kończenia etapu. Zainstaluj aplikację Azure Pipelines for Jira w chmurze Jira Software i dodaj organizację, aby utworzyć połączenie.

Aby zapewnić obsługę integracji ze śledzeniem problemów z usługą Jira, zainstaluj usługę Azure DevOps dla usługi Jira i połącz organizacje usługi Azure DevOps z wystąpieniem oprogramowania Jira. Możesz połączyć wiele organizacji z jednym wystąpieniem i pobrać dane dla wszystkich zespołów i powiązanych projektów. Aby uzyskać więcej informacji, zobacz Connect Azure DevOps to Jira (Łączenie usługi Azure DevOps z usługą Jira).

Powiązane artykuły

• Definiowanie potoku ciągłego wdrażania wieloetapowego (CD)
• Łączenie elementów roboczych z innymi obiektami
• Przegląd potoków wydania (wersja klasyczna)
• Pobieranie wszystkich elementów roboczych skojarzonych z potokiem wydania przy użyciu interfejsu API usługi Azure DevOps
• Wspieranie programowania w usłudze Git na podstawie elementu roboczego
• Łączenie elementów roboczych z innymi obiektami
• Zapewnianie kompleksowej możliwości śledzenia
• Zapoznaj się z dokumentacją typu łącza