Grupy zadań w potokach klasycznych
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
W potokach klasycznych grupa zadań hermetyzuje sekwencję zadań, które są już zdefiniowane w potoku w jednym zadaniu wielokrotnego użytku. Nowa grupa zadań jest automatycznie dodawana do wykazu zadań i może zostać dodana do potoków w projekcie tak samo jak w przypadku innych zadań. Grupy zadań są przechowywane na poziomie projektu i nie są dostępne poza zakresem projektu.
Grupy zadań to sposób standaryzacji i centralnego zarządzania krokami wdrażania dla wszystkich aplikacji. Gdy wprowadzisz zmianę centralnie do grupy zadań, zmiana zostanie automatycznie odzwierciedlona we wszystkich definicjach potoków korzystających z grupy zadań. Nie trzeba zmieniać poszczególnych definicji indywidualnie.
Wymagania wstępne
- Organizacja i projekt usługi Azure DevOps, w którym masz uprawnienia do tworzenia potoków.
- Potok klasyczny utworzony w projekcie.
Wyodrębnianie parametrów zadania jako zmiennych
Podczas tworzenia grupy zadań można wyodrębnić parametry z hermetyzowanych zadań jako zmiennych konfiguracji i wyodrębnić pozostałe informacje o zadaniu. Zmienne używane w zadaniach są automatycznie wyodrębniane i konwertowane na parametry dla grupy zadań, a wartości tych zmiennych konfiguracji są konwertowane na wartości domyślne dla grupy zadań.
Możesz również zmienić wartości domyślne parametrów podczas zapisywania nowej grupy zadań. Podczas kolejkowania przebiegu lub wydania potoku hermetyzowane zadania są wyodrębniane, a wartości wprowadzone dla parametrów grupy zadań są stosowane do zadań podrzędnych.
Przed utworzeniem grupy zadań należy zdefiniować wszystkie parametry, które mają być w stanie skonfigurować w uruchomieniach potoku jako zmienne, takie jak $(MyVariable). Wszystkie parametry zadania, które nie mają wartości lub mają określone wartości zamiast zmiennych, stają się stałymi parametrami i nie są widoczne dla grupy zadań jako konfigurowalne parametry.
Można również skonfigurować warunki zadania w grupie zadań, takie jak Uruchamianie tego zadania tylko wtedy, gdy poprzednie zadanie nie powiodło się dla zadania skryptu programu PowerShell, a warunki te są utrwalane w grupie zadań.
Uwaga
Grupy zadań są obsługiwane w potokach klasycznych i potokach wydania klasycznego.
Tworzenie grupy zadań
Podczas zapisywania nowej grupy zadań należy podać nazwę i opis i wybrać kategorię dla grupy zadań w wykazie zadań.
Otwórz potok, w którym chcesz utworzyć nową grupę zadań.
Aby upewnić się, że żadne z zadań, które mają zawierać jakiekolwiek parametry połączone, wybierz pozycję Odłącz wszystkie w panelu ustawień potoku, a następnie wybierz pozycję Potwierdź.
Wybierz sekwencję zadań potoku, które chcesz przekształcić w grupę zadań, kliknij prawym przyciskiem myszy, aby otworzyć menu kontekstowe, a następnie wybierz polecenie Utwórz grupę zadań.
Określ nazwę i opis nowej grupy zadań oraz kategorię w okienku Dodaj zadania , do którego chcesz dodać.
Wybierz pozycję Utwórz. Nowa grupa zadań jest tworzona i zastępuje wybrane zadania w potoku.
'$(vars)'Wszystkie z podstawowych zadań, z wyjątkiem wstępnie zdefiniowanych zmiennych, są wyświetlane jako obowiązkowe parametry dla nowo utworzonej grupy zadań i można edytować wartości w razie potrzeby.Jeśli na przykład masz dane wejściowe
foobarzadania, których nie zamierzasz sparametryzować, dane wejściowe zadania są konwertowane na parametr'foobar'grupy zadań . Możesz podać wartość domyślną parametru'foobar'$(foobar)grupy zadań, aby upewnić się, że w czasie wykonywania rozwinięte zadanie pobiera dane wejściowe, które zamierzasz.Zapisz zaktualizowany potok.
Zarządzanie grupami zadań
Wszystkie grupy zadań w bieżącym projekcie są wymienione w obszarze Potoki na stronie Grupy zadań.
W górnej części strony Grupy zadań możesz wybrać pozycję Importuj , aby zaimportować wcześniej zapisane definicje grup zadań. Za pomocą tej funkcji można przenosić grupy zadań między projektami i przedsiębiorstwami lub replikować i zapisywać kopie grup zadań.
Możesz również wybrać pozycję Zabezpieczenia w górnej części strony, aby zdefiniować, kto może używać, edytować, usuwać lub ustawiać uprawnienia dla wszystkich grup zadań w projekcie.
Aby zarządzać grupą zadań, kliknij prawym przyciskiem myszy lub wybierz ikonę Więcej akcji dla grupy i wybierz jedną z następujących opcji z menu kontekstowego:
- Wybierz pozycję Usuń , aby usunąć grupę zadań, a następnie ponownie wybierz pozycję Usuń na ekranie potwierdzenia.
- Wybierz pozycję Eksportuj , aby zapisać kopię grupy zadań jako potok JSON.
- Wybierz pozycję Zabezpieczenia , aby zdefiniować, kto może używać, edytować, usuwać lub ustawiać uprawnienia dla grupy zadań.
Aby otworzyć stronę szczegółów grupy zadań do edycji, wybierz nazwę grupy zadań na stronie Grupy zadań.
Na karcie Zadania można edytować zadania tworzące grupę zadań. Dla każdego hermetyzowanego zadania można zmienić wartości parametrów dla parametrów niewarianowalnych, edytować istniejące zmienne parametrów lub konwertować wartości parametrów na zmienne i z nich. Po zapisaniu zmian wszystkie definicje korzystające z grupy zadań pobierają zmiany.
Wszystkie parametry zmienne grupy zadań są wyświetlane jako obowiązkowe parametry w definicji potoku. Można również ustawić wartości domyślne dla parametrów grupy zadań.
Na karcie Historia można zobaczyć historię zmian w grupie.
Na karcie Odwołania można wyświetlić listy wszystkich potoków i innych grup zadań odwołujących się do tej grupy zadań. Ta lista pomaga upewnić się, że zmiany nie mają nieoczekiwanego wpływu na inne procesy.
Tworzenie wersji zapoznawczej i zaktualizowanie wersji grup zadań
Wszystkie wbudowane zadania usługi Azure Pipelines są wersjonowane. Przechowywanie wersji umożliwia potokom kontynuowanie korzystania z istniejącej wersji zadania podczas tworzenia, testowania i wydawania nowych wersji. Możesz wersję niestandardowych grup zadań w taki sam sposób, aby zapewnić te same korzyści.
Aby uruchomić wersję grupy zadań, po zakończeniu edytowania wybierz pozycję Zapisz jako wersję roboczą zamiast Zapisz.
Ciąg -test jest dołączany do numeru wersji grupy zadań. Jeśli zmiany są zadowolone, wybierz pozycję Publikuj wersję roboczą. Na ekranie Publikowanie grupy zadań roboczych wybierz pozycję Publikuj jako podgląd, jeśli chcesz opublikować nową wersję jako wersję zapoznawcza , a następnie wybierz pozycję Publikuj.
Teraz możesz użyć zaktualizowanej grupy zadań w procesach wydania. Możesz zmienić numer wersji w potokach, które już używają grupy zadań, lub wybrać grupę zadań w wersji w okienku Dodawanie zadań . Podobnie jak w przypadku wbudowanych zadań, ustawieniem domyślnym podczas dodawania grupy zadań jest najwyższa wersja spoza wersji zapoznawczej.
Po zakończeniu testowania zaktualizowanej grupy zadań wybierz pozycję Publikuj podgląd, a następnie wybierz pozycję Publikuj. Ciąg podglądu jest usuwany z numeru wersji, a wersja jest teraz wyświetlana w definicjach jako wersja gotowa do produkcji.
Teraz możesz wybrać nową wersję gotową do produkcji w potoku, który zawiera już grupę zadań. Po dodaniu grupy zadań z panelu Dodawanie zadań automatycznie wybiera nową wersję gotową do produkcji. Potok można edytować, aby używać starszej wersji.
Praca z wersjami grup zadań
Aktualizacje grupy zadań mogą być aktualizacjami wersji pomocniczej lub głównej.
Tworzenie aktualizacji wersji pomocniczej
Aby utworzyć aktualizację wersji pomocniczej, należy bezpośrednio zapisać grupę zadań po jej edycji zamiast zapisywać ją jako wersję roboczą.
Numer wersji nie zmienia się, a najnowsze zmiany są wyświetlane automatycznie w definicji potoku. Jeśli na przykład grupa zadań ma wersję 1, możesz mieć dowolną liczbę aktualizacji wersji pomocniczej, takich jak 1.1, 1.2i 1.3. W potoku wersja grupy zadań jest wyświetlana jako 1.*.
Użyj aktualizacji wersji pomocniczej w przypadku niewielkich zmian w grupie zadań, gdy oczekujesz, że potoki będą używać nowej zmiany bez zmiany numeru wersji w definicji potoku.
Tworzenie aktualizacji wersji głównej
Aby utworzyć nową wersję główną, należy zapisać aktualizacje grupy zadań jako wersję roboczą i utworzyć wersję zapoznawcza, zweryfikować zmiany, a następnie opublikować wersję zapoznawcza.
Ten proces zwiększa grupę zadań do nowej wersji. Jeśli masz grupę zadań z wersją 1.*, nowe wersje są publikowane jako 2.*, 3.*, 4.*i tak dalej.
Powiadomienie o dostępności nowej wersji jest wyświetlane we wszystkich definicjach potoków korzystających z grupy zadań. Użytkownicy muszą jawnie zaktualizować nową wersję grupy zadań, jeśli chcą jej używać w swoich potokach.
Po wprowadzeniu istotnych zmian, które mogą spowodować przerwanie istniejących potoków, możesz przetestować i wdrożyć zmiany jako nową wersję główną. Użytkownicy mogą zdecydować się na uaktualnienie do nowej wersji lub pozostać w bieżącej wersji. Ta funkcja jest taka sama jak zwykła aktualizacja wersji zadania.
Testowanie aktualizacji wersji pomocniczej
Jeśli aktualizacja grupy zadań nie jest zmianą powodującą niezgodność, ale chcesz najpierw przetestować, a następnie wymusić użycie najnowszych zmian przez wszystkie potoki, wykonaj następujące kroki:
- Zapisz zmiany grupy zadań jako wersję roboczą. Nowa robocza grupa zadań o nazwie <Taskgroupname> (Wersja robocza) jest tworzona wraz ze zmianami.
- Dodaj tę roboczą grupę zadań bezpośrednio do potoku testowego.
- Zweryfikuj zmiany w potoku testu. Gdy masz pewność co do zmian, wróć do głównej grupy zadań, wykonaj te same zmiany i zapisz je bezpośrednio. Zmiany są zapisywane jako aktualizacja wersji pomocniczej.
- Nowe zmiany są teraz wyświetlane we wszystkich potokach korzystających z tej grupy zadań. Teraz możesz usunąć roboczą grupę zadań.
Pomoc i obsługa techniczna
- Zapoznaj się z poradami dotyczącymi rozwiązywania problemów.
- Uzyskaj porady na temat Stack Overflow.
- Opublikuj swoje pytania, wyszukaj odpowiedzi lub zasugeruj funkcję w społeczności deweloperów usługi Azure DevOps.
- Uzyskaj pomoc techniczną dotyczącą usługi Azure DevOps.