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 indywidualnie zarządzać poszczególnymi agentami , 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 działa on na agencie z tej puli, która spełnia wymagania potoku.
Uwaga
Zarządzane pule agentów DevOps są zarządzane w witrynie Azure Portal. Jeśli używasz zarządzanych pul devOps, zobacz Tworzenie pierwszej zarządzanej puli DevOps.
W usłudze Azure Pipelines pule są ograniczone do całej organizacji; dzięki czemu można udostępniać maszyny agentów w projektach.
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 puli agentów uruchamiają zadanie na jednym agencie. Jeśli musisz uruchomić zadanie dla wszystkich agentów, takich jak grupa wdrożeń dla klasycznych potoków wydania, zobacz Aprowizuj grupy wdrożeń.
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 pozycję Pule agentów.
Zaloguj się do kolekcji projektów (
http://your-server/DefaultCollection).Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję 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.
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 : 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 Agenci hostowani przez firmę Microsoft.
Uwaga
Hostowana pula usługi Azure Pipelines zastępuje poprzednie hostowane pule, które mają nazwy mapowane 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 wersji pojedynczej puli hostowanej z 1 lipca 2019 r. — Sprint 154.
Domyślnie wszyscy współautorzy projektu są członkami roli Użytkownik w hostowanych pulach. Dzięki temu każdy współautor projektu może tworzyć i uruchamiać potoki przy użyciu agentów hostowanych przez firmę Microsoft.
Wyznaczanie puli w potoku
Aby wybrać agenta hostowanego przez firmę Microsoft z puli usługi Azure Pipelines w potoku YAML usług Azure DevOps Services, 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
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 pozycję Pule agentów.
Zaloguj się do kolekcji projektów (
http://your-server/DefaultCollection).Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję 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.
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 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 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 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 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 należeć do tej puli agentów.
Chcesz udostępnić zestaw maszyn agentów z wieloma projektami, 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 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 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 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 należeć do tej puli agentów.
Chcesz udostępnić zestaw maszyn agentów z wieloma projektami, 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.
Ustawienia zabezpieczeń na poziomie organizacji
| Rola w puli agentów w ustawieniach organizacji | Purpose |
|---|---|
| Czytelnik | Członkowie tej roli mogą wyświetlać pulę agentów, a także 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, zwykle nie musisz dodawać żadnych elementów członkowskich w tym miejscu. |
| 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". 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 | Purpose |
|---|---|
| Czytelnik | Członkowie tej roli mogą wyświetlać pulę agentów projektu. Zazwyczaj służy do dodawania operatorów odpowiedzialnych za monitorowanie zadań kompilacji i wdrażania w tej puli agentów projektu. |
| User | 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. |
Uprawnienia potoku
Uprawnienia potoku kontrolują, które potoki YAML są autoryzowane do korzystania z puli agentów. Uprawnienia potoku nie ograniczają dostępu z potoków klasycznych.
Możesz wybrać jedną z poniższych opcji:
Otwórz dostęp dla wszystkich potoków, aby użyć puli agentów z większej liczby opcji w prawym górnym rogu sekcji Uprawnienia potoku na karcie Zabezpieczenia puli agentów.
Zablokuj pulę agentów i zezwól na używanie tylko wybranych potoków YAML. Jeśli jakikolwiek inny potok YAML odwołuje się do puli agentów, zostanie zgłoszone żądanie autoryzacji, które musi zostać zatwierdzone przez administratora puli agentów. Nie ogranicza to dostępu z potoków klasycznych.
Nie można skonfigurować uprawnień potoku dla puli agentów usługi Azure Pipelines , ponieważ pula jest domyślnie dostępna dla wszystkich potoków.
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 wszystkich pul agentów: Administratorzy kompilacji, Administratorzy wydań, Administratorzy projektu.
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 z zdefiniowanych tutaj elementów. 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 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ł, aby agenci zabrakło 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 pozycję Pule agentów.
Zaloguj się do kolekcji projektów (
http://your-server/DefaultCollection).Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję Pule agentów.
Wybierz pozycję Azure DevOps, Ustawienia kolekcji.
Wybierz pozycję 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ń 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 odbywa się 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 własnych agentów wygląda na zablokowane. Dlaczego?
Zazwyczaj zadanie konserwacji zostaje „zablokowane”, gdy czeka 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 ustawione w kolejce do uruchomienia, będą czekać siedem dni na uruchomienie. 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 zadania konserwacji. Ten ostatni kontroluje maksymalną liczbę minut, które agent może spędzić na konserwacji. Czasomierz uruchamia się, gdy zadanie jest uruchamiane, a nie gdy zadanie jest umieszczane w kolejce na agencie.
Próbuję utworzyć pulę agentów projektu, która używa istniejącej puli agentów organizacji, ale kontrolki są wyszarane. 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ć przywoływane 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 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 co miesiąc bezpłatne minuty kompilacji. 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: