Tworzenie pul agentów i zarządzanie nimi
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Pula agentów to kolekcja agentów. Zamiast zarządzać każdym agentem indywidualnie, organizujesz agentów w pule. Podczas konfigurowania agenta jest on rejestrowany w jednej puli, a podczas tworzenia potoku określa się pulę, w której działa dany potok. Po uruchomieniu potoku działa on na agencie z tej puli, który spełnia wymagania potoku.
Uwaga
Zarządzane pule agentów DevOps są administrowane w Azure Portal. Jeśli używasz zarządzanych pul DevOps, zobacz Tworzenie swojej pierwszej zarządzanej puli DevOps.
W usłudze Azure Pipelines pule obejmują całą organizację, dzięki czemu można udostępniać maszyny agentów między projektami.
W usłudze Azure DevOps Server pule agentów są ograniczone do całego serwera; dzięki czemu można udostępniać maszyny agentów w projektach i kolekcjach.
Uwaga
Zadania na pulę agentów uruchamiają zadanie na jednym agencie. Jeśli musisz uruchomić zadanie dla wszystkich agentów, takich jak grupa wdrożeniowa dla klasycznych procesów wydania, zobacz Grupy wdrożeniowe.
Jeśli jesteś administratorem organizacji, pule agentów tworzysz i zarządzasz nimi na karcie Pule agentów w ustawieniach administratora.
Zaloguj się do swojej organizacji (
https://dev.azure.com/{yourorganization}).Wybierz pozycję Azure DevOps, Ustawienia organizacji.
Wybierz Pule agentów.
Zaloguj się do kolekcji projektów (
http://your-server/DefaultCollection).Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz Pule agentów.
Jeśli jesteś członkiem zespołu projektu, tworzysz pule agentów i zarządzasz 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.
Domyślne pule agentów
Następujące pule agentów są domyślnie udostępniane:
- Pula domyślna: Użyj jej do rejestrowania lokalnie umieszczonych agentów, które skonfigurowałeś.
Udostępniana pula usługi Azure Pipelines zawierająca różne obrazy systemów Windows, Linux i macOS. Aby uzyskać pełną listę dostępnych obrazów i ich zainstalowanego oprogramowania, zobacz Agenci hostowani przez Microsoft.
Uwaga
Hostowana pula usługi Azure Pipelines zastępuje poprzednie hostowane pule, których nazwy były odwzorowane na odpowiednie obrazy. Wszystkie zadania z poprzednich hostowanych pul są automatycznie przekierowywane do poprawnego obrazu w nowej puli hostowanej usługi Azure Pipelines. W niektórych sytuacjach 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 wydaniu pojedynczej hostowanej puli z 1 lipca 2019 r. — informacje o wydaniu Sprint 154.
Domyślnie wszyscy współautorzy projektu są członkami roli Użytkownik w hostowanych pulach. Dzięki temu każdy uczestnik projektu może tworzyć i uruchamiać potoki przy użyciu agentów hostowanych przez firmę Microsoft.
Wyznacz pulę w potoku
Aby wybrać agenta hostowanego przez firmę Microsoft z puli Azure Pipelines w potoku YAML w Azure DevOps Services, określ nazwę obrazu przy użyciu YAML VM Image Label 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-u dla pul.
Zarządzanie pulami i kolejkami
Jeśli jesteś administratorem organizacji, pule agentów tworzysz i zarządzasz nimi na karcie Pule agentów w ustawieniach administratora.
Zaloguj się do swojej organizacji (
https://dev.azure.com/{yourorganization}).Wybierz pozycję Azure DevOps, Ustawienia organizacji.
Wybierz Pule agentów.
Zaloguj się do kolekcji projektów (
http://your-server/DefaultCollection).Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz Pule agentów.
Jeśli jesteś członkiem zespołu projektu, tworzysz pule agentów i zarządzasz 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.
Aby usunąć pulę, przejdź do listy Pule agentów , wybierz pozycję Więcej opcji, Usuń.
Pule służą do uruchamiania zadań. Dowiedz się więcej o określaniu pul dla zadań.
Jeśli posiadasz 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 można utworzyć pule własnych agentów:
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 koniec zainstaluj i skonfiguruj agentów, aby stać się częścią 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 masz uprawnienia do tworzenia pul w projekcie, wybierając pozycję Zabezpieczenia na stronie Pule agentów w ustawieniach organizacji. Następnie utwórz nową pulę agentów i wybierz opcję Automatyczne aprowizowanie tej puli 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 stać się częścią tej puli agentów.
Chcesz udostępnić zestaw maszyn agentów dla wielu projektów, ale nie ze wszystkimi. 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 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 koniec zainstaluj i skonfiguruj agentów, aby stać się częścią 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 masz uprawnienia do tworzenia pul w projekcie, wybierając pozycję Zabezpieczenia na stronie Pule agentów w ustawieniach kolekcji projektu. Następnie utwórz nową pulę agentów i wybierz opcję Automatyczne aprowizowanie tej puli 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 stać się częścią tej puli agentów.
Chcesz podzielić się zestawem maszyn agentów z wieloma projektami, ale nie ze wszystkimi. 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.
Bezpieczeństwo pul agentów
Zrozumienie, jak funkcjonują zabezpieczenia 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.
Ustawienia zabezpieczeń na poziomie organizacji
| Rola w puli agentów w ustawieniach organizacyjnych | Cel |
|---|---|
| Czytelnik | Członkowie tej roli mogą wyświetlać zarówno pulę agentów, jak i samych agentów. Zazwyczaj służy 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 musisz tutaj dodawać żadnych członków. |
| 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 jest używany do zarządzania bezpieczeństwem 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". Domyślnie administratorzy serwera TFS i Azure DevOps Server są również administratorami węzła "Wszystkie pule agentów" podczas korzystania z serwera TFS lub Azure DevOps Server.
Ustawienia zabezpieczeń na poziomie projektu
Role są również definiowane w każdej puli agentów projektu, a członkostwa w tych rolach określają, jakie operacje można wykonać w puli agentów na poziomie projektu.
| Rola w puli agentów w ustawieniach projektu | Cel |
|---|---|
| Czytelnik | Członkowie roli mogą przeglądać pulę agentów projektu. Używasz tego zazwyczaj 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 wszystkich ról w puli agentów projektu. Użytkownik, który utworzył pulę, jest automatycznie dodawany do roli Administrator dla tej puli. |
Uprawnienia potoku
Uprawnienia potoków kontrolują, które potoki YAML są autoryzowane na użycie puli agentów. Uprawnienia pipelines nie ograniczają dostępu do potoków klasycznych.
Możesz wybrać jedną z poniższych opcji:
Otwórz dostęp dla wszystkich potoków do korzystania z puli agentów, wybierając Więcej opcji w prawym górnym rogu sekcji Uprawnienia potoku na karcie Zabezpieczenia puli agentów.
Ogranicz dostęp do puli agentów i zezwól na używanie jedynie wybranych potoków YAML. Jeśli jakakolwiek inna rura YAML odwołuje się do puli agentów, zostanie zgłoszony wniosek o autoryzację, który musi zostać zaaprobowany przez administratora puli agentów. Nie ogranicza to dostępu z potoków klasycznych.
Nie można skonfigurować uprawnień potoku dla puli agentów Azure Pipelines, ponieważ pula jest domyślnie dostępna dla wszystkich potoków.
Akcja Zabezpieczenia na karcie Pule agentów służy do kontrolowania zabezpieczeń wszystkich pul agentów projektu w projekcie. Członkostwa w rolach dla poszczególnych pul agentów projektu są automatycznie dziedziczone na podstawie ustawień zdefiniowanych tutaj. Domyślnie następujące grupy są dodawane do roli Administrator wszystkich pul agentów: Administratorzy kompilacji, Administratorzy wydań, Administratorzy projektu.
Często zadawane pytania
Jeśli nie zaplanuję okna serwisowego, kiedy agenci przeprowadzą konserwację?
Jeśli nie zaplanowano okna, agenci w tej puli nie będą uruchamiać prac konserwacyjnych.
Co to jest zadanie konserwacji?
Pule agentów można skonfigurować do okresowego czyszczenia nieaktualnych katalogów roboczych i repozytoriów. Powinno to zmniejszyć ryzyko, że agentom zabraknie miejsca na dysku. Zadania konserwacji są konfigurowane na poziomie organizacji w ustawieniach puli agentów.
Aby skonfigurować ustawienia zadania konserwacji:
Zaloguj się do swojej organizacji (
https://dev.azure.com/{yourorganization}).Wybierz pozycję Azure DevOps, Ustawienia organizacji.
Wybierz Pule agentów.
Zaloguj się do kolekcji projektów (
http://your-server/DefaultCollection).Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz Pule agentów.
Wybierz żądaną pulę i wybierz pozycję Ustawienia , aby skonfigurować ustawienia zadań konserwacji dla tej puli agentów.
Ważne
Aby skonfigurować ustawienia zadań konserwacyjnych, 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.
Konserwację przeprowadza się w kontekście puli agentów, a nie maszyny. W rezultacie, jeśli masz wiele pul agentów na jednej maszynie, mogą nadal wystąpić problemy z przestrzenią dyskową.
Zadanie utrzymania puli agentów, którą samodzielnie hostuję, wygląda na zablokowane. Dlaczego?
Zazwyczaj zadanie konserwacyjne zostaje „zablokowane”, gdy czeka na uruchomienie na agencie, który nie jest już dostępny 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 ustawione w kolejce do wykonania, będą czekać siedem dni na wykonanie. Następnie zostaną one automatycznie ustawione w stan niepowodzenia, jeśli nie zostaną uruchomione. Nie można zmienić tego limitu czasu.
Limit siedmiu dni różni się od ustawienia limitu czasu pracy konserwacyjnej. Ten ostatni kontroluje maksymalną liczbę minut, które agent może spędzić na konserwacji. Czasomierz rozpoczyna odliczanie, kiedy zadanie zostaje uruchomione, a nie gdy jest umieszczane w kolejce u agenta.
Próbuję utworzyć pulę agentów projektu, która używa istniejącej puli agentów organizacji, ale opcje są wyszarzone. 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łynięta przez inną pulę agentów projektu. Każda pula agentów organizacji może być odwoływana tylko przez jedną pulę agentów projektu w ramach danej kolekcji projektów.
Nie mogę wybrać puli hostowanej przez firmę Microsoft i nie mogę ustawić w kolejce mojej kompilacji. Jak to naprawić?
Poproś właściciela organizacji usługi Azure DevOps o udzielenie Ci uprawnień do korzystania z puli. Zobacz Bezpieczeństwo pul agentów.
Potrzebuję więcej hostowanych zasobów kompilacji. Co mogę zrobić?
Pula usługi Azure Pipelines udostępnia wszystkim organizacjom Azure DevOps agentów kompilacji hostowanych w chmurze oraz bezpłatne minuty kompilacji każdego miesiąca. Jeśli potrzebujesz więcej zasobów kompilacji hostowanych przez firmę Microsoft lub musisz uruchomić więcej zadań równolegle, możesz wykonać następujące czynności: