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.

W usłudze Azure Pipelines pule są ograniczone do całej organizacji; dzięki czemu można udostępniać maszyny agentów w projektach.

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, tworzysz pule agentów i zarządzasz nimi na karcie Pule agentów w ustawieniach administratora.

1. Zaloguj się do organizacji (https://dev.azure.com/{yourorganization}).

2. Wybierz pozycję Azure DevOps, Ustawienia organizacji.

   

3. 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.

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

YAML

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

Aby uzyskać więcej informacji, zobacz schemat YAML dla pul.

Klasyczny

Aby wybrać pulę i agenta w edytorze klasycznym, przejdź do ustawień potoku, wybierz żądaną pulę agentów, a następnie z listy rozwijanej Specyfikacja agenta. Domyślna specyfikacja agenta to windows-2019. Aby uzyskać więcej informacji na temat oprogramowania zainstalowanego na obrazach hostowanych przez firmę Microsoft, zobacz odpowiedni wpis w kolumnie Pula edytora klasycznego z tej tabeli.

Zarządzanie pulami i kolejkami

Przeglądarka

Jeśli jesteś administratorem organizacji, tworzysz pule agentów i zarządzasz nimi na karcie Pule agentów w ustawieniach administratora.

1. Zaloguj się do organizacji (https://dev.azure.com/{yourorganization}).

2. Wybierz pozycję Azure DevOps, Ustawienia organizacji.

   

3. 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.

Interfejs wiersza polecenia usługi Azure DevOps

Lista pul agentów | Pokaż szczegóły | puli agentów Kolejki agenta | Pokaż szczegóły kolejki agenta

Uwaga

W tej chwili można wyświetlić informacje o pulach agentów i kolejkach, ale nie edytować ich przy użyciu interfejsu wiersza polecenia platformy Azure.

Jeśli używasz poleceń po raz az devops pipelines pierwszy, zobacz Rozpoczynanie pracy z interfejsem wiersza polecenia usługi Azure DevOps.

Wyświetlanie listy pul agentów

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parametry

• action: Filtruj listę za pomocą dozwolonej akcji użytkownika. Zaakceptowane wartości: zarządzanie, brak, używanie
• wykryj: Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true
• organizacja lub organizacja: adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
• nazwa puli: przefiltruj listę przy użyciu pasującej nazwy puli.
• typ puli: filtruj listę z typem puli. Akceptowane wartości: automatyzacja, wdrażanie

Przykład

W poniższym przykładzie wymieniono wszystkie pule w formacie tabeli. W tym przykładzie użyto następującej konfiguracji domyślnej: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool list --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Pokaż szczegóły puli agentów

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parametry

• identyfikator lub identyfikator puli: (wymagany) identyfikator puli, aby wyświetlić szczegóły.
• action: Filtruj listę za pomocą dozwolonej akcji użytkownika. Zaakceptowane wartości: zarządzanie, brak, używanie
• wykryj: Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true
• organizacja lub organizacja: adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.

Przykład

Poniższy przykład przedstawia szczegóły puli dla puli hostowanej systemu Windows 2019 z pulą VS2019. W tym przykładzie użyto następującej konfiguracji domyślnej: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

Można również użyć --output table funkcji , która zwraca te same informacje co list polecenie .

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Wyświetlanie listy kolejek agentów

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parametry

• action: Filtruj listę za pomocą dozwolonej akcji użytkownika. Zaakceptowane wartości: zarządzanie, brak, używanie
• wykryj: Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true
• organizacja lub organizacja: adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
• projekt lub p: nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=NAME_OR_ID. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git.
• queue-name: Przefiltruj listę z pasującą nazwą kolejki regex, np. ubuntu dla kolejki o nazwie "Hosted Ubuntu 1604".

Przykład

W poniższym przykładzie wymieniono wszystkie kolejki w formacie tabeli. W tym przykładzie użyto następującej konfiguracji domyślnej: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue list --output table
This command group is in preview. It may be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Pokaż szczegóły kolejki agenta

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parametry

• id lub queue-id: identyfikator kolejki agenta, aby uzyskać informacje.
• action: Filtruj listę za pomocą dozwolonej akcji użytkownika. Zaakceptowane wartości: zarządzanie, brak, używanie
• wykryj: Automatycznie wykrywaj organizację. Zaakceptowane wartości: false, true
• organizacja lub organizacja: adres URL organizacji usługi Azure DevOps. Domyślną organizację można skonfigurować przy użyciu polecenia az devops configure -d organization=ORG_URL. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git. Przykład: https://dev.azure.com/MyOrganizationName/.
• projekt lub p: nazwa lub identyfikator projektu. Projekt domyślny można skonfigurować przy użyciu polecenia az devops configure -d project=NAME_OR_ID. Wymagane, jeśli ustawienie nie jest skonfigurowane jako domyślne lub odebrane za pośrednictwem konfiguracji usługi Git.

Przykład

W poniższym przykładzie przedstawiono szczegóły kolejki dla kolejki hostowanej systemu Windows 2019 z kolejką PROGRAMU VS2019. W tym przykładzie użyto następującej konfiguracji domyślnej: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

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ę Administracja istratora. 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.

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 Administracja istrator 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 Administracja istrator 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 Administracja istrator 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.

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 Administracja istratora "Wszystkie pule agentów": Build Administracja istrators, Release Administracja istrators, Project Administracja istrators.

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:

1. Zaloguj się do organizacji (https://dev.azure.com/{yourorganization}).

2. Wybierz pozycję Azure DevOps, Ustawienia organizacji.

   

3. Wybierz pozycję Pule agentów.

   

Wybierz żądaną pulę i wybierz 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 Administracja istrator. 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:

• Hostowanie własnych agentów w infrastrukturze, którą zarządzasz
• Kupowanie dodatkowych zadań równoległych