Tworzenie pul agentów i zarządzanie nimi
Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018
Uwaga
W Microsoft Team Foundation Server (TFS) 2018 i poprzednich wersjach potoki kompilacji i wydania są nazywane definicjami, uruchomienia są nazywane kompilacjami, połączenia usługi są nazywane punktami końcowymi usługi, etapami są nazywane środowiskami, a zadania są nazywane fazami.
Pula agentów to kolekcja agentów. Zamiast zarządzać poszczególnymi agentami osobno, należy organizować agentów w pule agentów. W programie TFS pule są ograniczone do całego serwera; dzięki temu można udostępnić pulę agentów w kolekcjach projektów i projektach.
Kolejka agentów zapewnia dostęp do puli agentów w projekcie. Podczas tworzenia potoku kompilacji lub wydania należy określić, która kolejka jest używana. Kolejki są ograniczone do projektu w programie TFS 2017 i nowszych, dzięki czemu można ich używać tylko w potokach kompilacji i wydania w projekcie.
Aby udostępnić pulę agentów wielu projektom, w każdym z tych projektów należy utworzyć kolejkę agentów wskazującą tę samą pulę agentów. Chociaż wiele kolejek między projektami może używać tej samej puli agentów, wiele kolejek w projekcie nie może używać tej samej puli agentów. Ponadto każda kolejka agentów może używać tylko jednej puli agentów.
Pula agentów to kolekcja agentów. Zamiast zarządzać poszczególnymi agentami osobno, należy organizować agentów w pule agentów. Podczas konfigurowania agenta jest on rejestrowany w jednej puli, a podczas tworzenia potoku określa się pulę, w której działa potok. Po uruchomieniu potoku jest on uruchamiany na agencie z tej puli, która spełnia wymagania potoku.
W usłudze Azure Pipelines pule są ograniczone do całej organizacji; dzięki temu można udostępniać maszyny agentów między projektami.
W Azure DevOps Server zakresy pul agentów są ograniczone do całego serwera, dzięki czemu można udostępniać maszyny agentów między projektami i kolekcjami.
Uwaga
Zadania puli agentów uruchamiają zadanie na jednym agencie. Jeśli musisz uruchomić zadanie dla wszystkich agentów, takich jak grupa wdrażania dla klasycznych potoków wydania, zobacz Aprowizuj grupy wdrożeń.
Pule agentów można tworzyć i zarządzać nimi na karcie Pule agentów w ustawieniach administratora.
Jeśli jesteś administratorem organizacji, tworzysz pule agentów i zarządzasz nimi na karcie Pule agentów w ustawieniach administratora.
Wybierz pozycję Azure DevOps, Ustawienia organizacji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia (ikona koła zębatego) >Kolejki agentów.
Wybierz pozycję Zarządzaj pulami.
Kolejki agentów można tworzyć i zarządzać nimi na karcie Kolejki agentów w ustawieniach projektu.
Jeśli jesteś członkiem zespołu projektu, możesz tworzyć kolejki agentów i zarządzać nimi na karcie Pule agentów w ustawieniach projektu.
Przejdź do projektu i wybierz pozycję Ustawienia projektu, Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia projektu, Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia projektu, Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia (ikona koła zębatego) >Kolejki agentów.
Domyślne pule agentów
Domyślnie dostępne są następujące pule agentów:
- Pula domyślna : służy do rejestrowania skonfigurowanych samodzielnie agentów .
Hostowana pula usługi Azure Pipelines z różnymi obrazami systemu Windows, Linux i macOS. Aby uzyskać pełną listę dostępnych obrazów i zainstalowanego oprogramowania, zobacz Agentów hostowanych przez firmę Microsoft.
Uwaga
Hostowana pula usługi Azure Pipelines zastępuje poprzednie hostowane pule, które miały nazwy mapowane na odpowiednie obrazy. Wszystkie zadania z poprzednich hostowanych pul są automatycznie przekierowywane do poprawnego obrazu w nowej puli hostowanej w usłudze Azure Pipelines. W niektórych okolicznościach nadal mogą być widoczne stare nazwy puli, ale w tle hostowane zadania są uruchamiane przy użyciu puli usługi Azure Pipelines. Aby uzyskać więcej informacji, zobacz informacje o wersji pojedynczej puli hostowanej z informacji o wersji z 1 lipca 2019 r. — Sprint 154.
Domyślnie wszyscy współautorzy w projekcie są członkami roli Użytkownik w hostowanych pulach. Dzięki temu każdy współautor w projekcie może tworzyć i uruchamiać potoki przy użyciu agentów hostowanych przez firmę Microsoft.
Wyznaczanie puli w potoku
Potoki YAML są obsługiwane w Azure DevOps Server 2019 i nowszych wersjach.
Aby wybrać agenta hostowanego przez firmę Microsoft z puli usługi Azure Pipelines w potoku Azure DevOps Services YAML, określ nazwę obrazu przy użyciu etykiety obrazu maszyny wirtualnej YAML z tej tabeli.
pool:
vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.
Aby użyć puli prywatnej bez wymagań:
pool: MyPool
Aby uzyskać więcej informacji, zobacz schemat YAML dla pul.
Zarządzanie pulami i kolejkami
Pule agentów można tworzyć i zarządzać nimi na karcie Pule agentów w ustawieniach administratora.
Jeśli jesteś administratorem organizacji, tworzysz pule agentów i zarządzasz nimi na karcie Pule agentów w ustawieniach administratora.
Wybierz pozycję Azure DevOps, Ustawienia organizacji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia (ikona koła zębatego) >Kolejki agentów.
Wybierz pozycję Zarządzaj pulami.
Kolejki agentów można tworzyć i zarządzać nimi na karcie Kolejki agentów w ustawieniach projektu.
Jeśli jesteś członkiem zespołu projektu, możesz tworzyć kolejki agentów i zarządzać nimi na karcie Pule agentów w ustawieniach projektu.
Przejdź do projektu i wybierz pozycję Ustawienia projektu, Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia projektu, Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia projektu, Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia (ikona koła zębatego) >Kolejki agentów.
Pule służą do uruchamiania zadań. Dowiedz się więcej o określaniu pul dla zadań.
Jeśli masz wielu własnych agentów przeznaczonych dla różnych zespołów lub celów, możesz utworzyć dodatkowe pule, jak wyjaśniono poniżej.
Tworzenie pul agentów
Poniżej przedstawiono niektóre typowe sytuacje, w których warto utworzyć pule agentów hostowanych samodzielnie:
Jesteś członkiem projektu i chcesz użyć zestawu maszyn należących do zespołu do uruchamiania zadań kompilacji i wdrażania. Najpierw upewnij się, że masz uprawnienia do tworzenia pul w projekcie, wybierając pozycję Zabezpieczenia na stronie Pule agentów w ustawieniach projektu. Aby móc tworzyć nowe pule, musisz mieć rolę administratora . Następnie wybierz pozycję Dodaj pulę i wybierz opcję utworzenia nowej puli na poziomie organizacji. Na koniec zainstaluj i skonfiguruj agentów, aby należeć do tej puli agentów.
Jesteś członkiem zespołu infrastruktury i chcesz skonfigurować pulę agentów do użycia we wszystkich projektach. Najpierw upewnij się, że jesteś członkiem grupy w obszarze Wszystkie pule agentów z rolą Administrator , przechodząc do strony pule agentów w ustawieniach organizacji. Następnie utwórz nową pulę agentów i wybierz opcję Automatyczne aprowizowanie odpowiednich pul agentów we wszystkich projektach podczas tworzenia puli. To ustawienie zapewnia, że wszystkie projekty mają dostęp do tej puli agentów. Na koniec zainstaluj i skonfiguruj agentów, aby należeć do tej puli agentów.
Chcesz udostępnić zestaw maszyn agentów wielu projektom, ale nie wszystkie z nich. Najpierw przejdź do ustawień jednego z projektów, dodaj pulę agentów i wybierz opcję utworzenia nowej puli na poziomie organizacji. Następnie przejdź do każdego z pozostałych projektów i utwórz pulę w każdym z nich, wybierając opcję Użyj istniejącej puli agentów z organizacji. Na koniec zainstaluj i skonfiguruj agentów, aby należeć do puli agentów udostępnionych.
Jesteś członkiem projektu i chcesz użyć zestawu maszyn należących do zespołu do uruchamiania zadań kompilacji i wdrażania. Najpierw upewnij się, że jesteś członkiem grupy w obszarze Wszystkie pule z rolą Administrator . Następnie utwórz pulę nowych agentów projektu w ustawieniach projektu i wybierz opcję Utwórz nową pulę agentów organizacji. W związku z tym zostanie utworzona zarówno organizacja, jak i pula agentów na poziomie projektu. Na koniec zainstaluj i skonfiguruj agentów, aby należeć do tej puli agentów.
Jesteś członkiem zespołu infrastruktury i chcesz skonfigurować pulę agentów do użycia we wszystkich projektach. Najpierw upewnij się, że jesteś członkiem grupy w obszarze Wszystkie pule z rolą Administrator . Następnie utwórz nową pulę agentów organizacji w ustawieniach administratora i wybierz opcję Automatyczne aprowizowanie odpowiednich pul agentów projektu we wszystkich projektach podczas tworzenia puli. To ustawienie zapewnia, że wszystkie projekty mają pulę wskazującą pulę agentów organizacji. System tworzy pulę dla istniejących projektów, a w przyszłości zrobi to za każdym razem, gdy zostanie utworzony nowy projekt. Na koniec zainstaluj i skonfiguruj agentów, aby należeć do tej puli agentów.
Chcesz udostępnić zestaw maszyn agentów z wieloma projektami, ale nie wszystkie z nich. Najpierw utwórz pulę agentów projektu w jednym z projektów i wybierz opcję Utwórz nową pulę agentów organizacji podczas tworzenia tej puli. Następnie przejdź do każdego z pozostałych projektów i utwórz pulę w każdym z nich, wybierając opcję Użyj istniejącej puli agentów organizacji. Na koniec zainstaluj i skonfiguruj agentów, aby należeć do puli agentów udostępnionych.
Zabezpieczenia pul agentów
Zrozumienie sposobu działania zabezpieczeń pul agentów ułatwia kontrolowanie udostępniania i używania agentów.
Role są definiowane w każdej puli agentów, a członkostwo w tych rolach określa, jakie operacje można wykonać w puli agentów.
| Rola w puli agentów w ustawieniach organizacji | Przeznaczenie |
|---|---|
| Czytelnik | Członkowie tej roli mogą wyświetlać pulę agentów, a także agentów. Zazwyczaj jest to używane do dodawania operatorów odpowiedzialnych za monitorowanie agentów i ich kondycji. |
| Konto usługi | Członkowie tej roli mogą używać puli agentów organizacji do tworzenia puli agentów projektu w projekcie. Jeśli zastosujesz się do powyższych wytycznych dotyczących tworzenia nowych pul agentów projektu, zazwyczaj nie trzeba dodawać żadnych elementów członkowskich. |
| Administrator | Oprócz wszystkich powyższych uprawnień członkowie tej roli mogą rejestrować lub wyrejestrować agentów z puli agentów organizacji. Mogą również odwoływać się do puli agentów organizacji podczas tworzenia puli agentów projektu w projekcie. Na koniec mogą również zarządzać członkostwem dla wszystkich ról puli agentów organizacji. Użytkownik, który utworzył pulę agentów organizacji, jest automatycznie dodawany do roli Administrator dla tej puli. |
Węzeł Wszystkie pule agentów na karcie Pule agentów służy do kontrolowania zabezpieczeń wszystkich pul agentów organizacji. Członkostwo w rolach dla poszczególnych pul agentów organizacji jest automatycznie dziedziczone z tych z węzła "Wszystkie pule agentów". W przypadku korzystania z serwera TFS lub Azure DevOps Server domyślnie administratorzy TFS i Azure DevOps Server są również administratorami węzła "Wszystkie pule agentów".
Role są również definiowane w każdej puli agentów projektu, a członkostwa w tych rolach określają, jakie operacje można wykonywać w puli agentów na poziomie projektu.
| Rola w puli agentów w ustawieniach projektu | Przeznaczenie |
|---|---|
| Czytelnik | Członkowie tej roli mogą wyświetlać pulę agentów projektu. Zazwyczaj jest to używane do dodawania operatorów odpowiedzialnych za monitorowanie zadań kompilacji i wdrażania w tej puli agentów projektu. |
| Użytkownik | Członkowie tej roli mogą używać puli agentów projektu podczas tworzenia potoków. |
| Administrator | Oprócz wszystkich powyższych operacji członkowie tej roli mogą zarządzać członkostwem dla wszystkich ról puli agentów projektu. Użytkownik, który utworzył pulę, jest automatycznie dodawany do roli Administrator dla tej puli. |
Węzeł Wszystkie pule agentów na karcie Pule agentów służy do kontrolowania zabezpieczeń wszystkich pul agentów projektu w projekcie. Członkostwo w rolach dla poszczególnych pul agentów projektu jest automatycznie dziedziczone z tych z węzła "Wszystkie pule agentów". Domyślnie następujące grupy są dodawane do roli administratorów "Wszystkie pule agentów": Administratorzy kompilacji, Administratorzy wydania, Administratorzy projektu.
Akcja Zabezpieczenia na karcie Pule agentów służy do kontrolowania zabezpieczeń wszystkich pul agentów projektu w projekcie. Członkostwo w rolach dla poszczególnych pul agentów projektu jest automatycznie dziedziczone z elementów zdefiniowanych w tym miejscu. Domyślnie następujące grupy są dodawane do roli administratorów "Wszystkie pule agentów": Administratorzy kompilacji, Administratorzy wydania, Administratorzy projektu.
Często zadawane pytania
Jeśli nie zaplanuję okna obsługi, kiedy agenci będą uruchamiać konserwację?
Jeśli nie zaplanowano okna, agenci w tej puli nie będą uruchamiać zadania konserwacji.
Co to jest zadanie konserwacji?
Pule agentów można skonfigurować do okresowego czyszczenia nieaktualnych katalogów roboczych i repozytoriów. Powinno to zmniejszyć potencjał agentów, aby zabrakło miejsca na dysku. Zadania konserwacji są konfigurowane na poziomie kolekcji projektów lub organizacji w ustawieniach puli agentów.
Aby skonfigurować ustawienia zadania konserwacji:
Wybierz pozycję Azure DevOps, Ustawienia organizacji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Przejdź do projektu i wybierz pozycję Ustawienia (ikona koła zębatego) >Kolejki agentów.
Wybierz pozycję Zarządzaj pulami.
Wybierz żądaną pulę i wybierz pozycję Ustawienia , aby skonfigurować ustawienia zadania konserwacji dla tej puli agentów.
Ważne
Aby skonfigurować ustawienia zadania konserwacji, musisz mieć uprawnienie Zarządzanie kolejkami kompilacji . Jeśli nie widzisz karty Ustawienia lub karty Historia konserwacji , nie masz tego uprawnienia, które jest domyślnie przyznawane roli Administrator . Aby uzyskać więcej informacji, zobacz Zabezpieczenia pul agentów.
Skonfiguruj żądane ustawienia i wybierz pozycję Zapisz.
Wybierz pozycję Historia konserwacji , aby wyświetlić historię zadań konserwacji dla bieżącej puli agentów. Dzienniki można pobrać i przejrzeć, aby zobaczyć wykonane kroki czyszczenia i akcje.
Konserwacja jest wykonywana na pulę agentów, a nie na maszynę; dlatego jeśli masz wiele pul agentów na jednej maszynie, nadal mogą wystąpić problemy z miejscem na dysku.
Zadanie konserwacji puli agentów hostowanych samodzielnie wygląda na zablokowane. Dlaczego?
Zazwyczaj zadanie konserwacji jest "zablokowane", gdy oczekuje na uruchomienie agenta, który nie znajduje się już w puli agentów. Dzieje się tak, gdy na przykład agent został celowo przełączony w tryb offline lub gdy występują problemy z komunikacją z nim.
Zadania konserwacji, które zostały uruchomione w kolejce, będą czekać siedem dni na uruchomienie. Następnie zostaną one automatycznie ustawione na stan niepowodzenia, jeśli nie zostanie uruchomiony. Nie można zmienić tego limitu czasu.
Limit siedmiu dni różni się od ustawienia limitu czasu zadania konserwacji . Ta ostatnia steruje maksymalną liczbą minut, przez które agent może spędzić konserwację. Czasomierz uruchamia się po uruchomieniu zadania, a nie wtedy, gdy zadanie jest w kolejce do agenta.
Próbuję utworzyć pulę agentów projektu, która używa istniejącej puli agentów organizacji, ale kontrolki są wyszarywane. Dlaczego?
W oknie dialogowym "Tworzenie puli agentów projektu" nie można użyć istniejącej puli agentów organizacji, jeśli jest już przywołyniona przez inną pulę agentów projektu. Do każdej puli agentów organizacji można odwoływać się tylko przez jedną pulę agentów projektu w ramach danej kolekcji projektów.
Nie mogę wybrać puli hostowanej przez firmę Microsoft i nie mogę utworzyć kolejki kompilacji. Jak mogę rozwiązać ten problem?
Poproś właściciela organizacji usługi Azure DevOps o udzielenie Ci uprawnień do korzystania z puli. Zobacz Zabezpieczenia pul agentów.
Potrzebuję więcej hostowanych zasobów kompilacji. Co mogę zrobić?
1: Pula usługi Azure Pipelines udostępnia wszystkie organizacje usługi Azure DevOps z agentami kompilacji hostowanymi w chmurze i bezpłatną minutą kompilacji każdego miesiąca. Jeśli potrzebujesz więcej zasobów kompilacji hostowanych przez firmę Microsoft lub musisz równolegle uruchomić więcej zadań, możesz wykonać następujące czynności: