Vytváření a správa fondů agentů

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Fond agentů je kolekce agentů. Místo správy jednotlivých agentů uspořádáte agenty do fondů agentů. Když nakonfigurujete agenta, zaregistruje se v jednom fondu a při vytváření pipeline specifikujete fond, ve kterém se pipeline spouští. Když spustíte potrubí, spustí se na agentovi z tohoto fondu, který splňuje požadavky potrubí.

Poznámka:

Spravované fondy agentů DevOps se spravují na webu Azure Portal. Pokud používáte spravované fondy DevOps, přečtěte si téma Vytvoření prvního spravovaného fondu DevOps.

Ve službě Azure Pipelines jsou pooly vymezeny na úrovni celé organizace, takže můžete sdílet počítače agentů mezi projekty.

Poznámka:

Úlohy skupiny agentů spouští úlohu na jednom serveru. Pokud potřebujete spustit úlohu na všech agentech, jako je skupina nasazení pro klasické vydávací kanály, přečtěte si téma Vytvoření skupin nasazení.

Pokud jste správcem organizace, fondy agentů vytváříte a spravujete na kartě Fondy agentů v nastavení správce.

1. Přihlaste se ke své organizaci (https://dev.azure.com/{yourorganization}).

2. Zvolte Azure DevOps, nastavení organizace.

   

3. Vyberte agentové fondy.

   

Pokud jste členem projektového týmu, vytvoříte a spravujete fondy agentů na kartě Fondy agentů v nastavení projektu.

Přejděte do svého projektu a zvolte Nastavení projektu, Fondy agentů.

Výchozí fondy agentů

Ve výchozím nastavení jsou k dispozici následující fondy agentů:

• Výchozí fond: Použijte jej k registraci vlastnoručně hostovaných agentů, které jste nastavili.

• Hostovaný fond Azure Pipelines s různými obrazy Windows, Linuxu a macOS. Úplný seznam dostupných imagí a jejich nainstalovaného softwaru najdete v tématu Agenti hostovaní Microsoftem.

  Poznámka:

  Hostovaný fond Azure Pipelines nahrazuje předchozí hostované fondy s názvy mapovanými na odpovídající image. Všechny úlohy, které jste měli v předchozích hostovaných fondech, jsou automaticky přesměrovány na správný obraz v novém hostovaném fondu Azure Pipelines. V některých případech se stále mohou zobrazovat staré názvy fondů, ale na pozadí se hostované úlohy spouštějí pomocí fondu Azure Pipelines. Další informace najdete v poznámkách k vydání pro jeden hostovaný pool z poznámek k vydání ze dne 1. července 2019 – Sprint 154.

Ve výchozím nastavení jsou všichni přispěvatelé v projektu členy role Uživatel v hostovaných fondech. To umožňuje všem přispěvatelům v projektu vytvářet a spouštět kanály pomocí agentů hostovaných Microsoftem.

Označte fond ve svém procesu

YAML

Pokud chcete zvolit agenta hostovaného Microsoftem z fondu Azure Pipelines v potrubí YAML služby Azure DevOps Services, zadejte název obrazu pomocí označení obrazu virtuálního počítače YAML z této tabulky.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Jak používat soukromý bazén bez požadavků:

pool: MyPool

Další informace najdete ve schématu YAML pro fondy.

Klasické

Pokud chcete zvolit pool a agenta v klasickém editoru, přejděte do nastavení pipeline, vyberte požadovaný Agent pool a potom z rozevíracího seznamu Agent Specification požadovaný obrázek. Výchozí specifikace agenta je windows-2019. Další informace o softwaru nainstalovaném na imagích hostovaných Microsoftem najdete v odpovídající položce ve sloupci Fond klasických editorů z této tabulky.

Správa fondů a front

Uživatelské rozhraní Azure Pipelines

Pokud jste správcem organizace, fondy agentů vytváříte a spravujete na kartě Fondy agentů v nastavení správce.

1. Přihlaste se ke své organizaci (https://dev.azure.com/{yourorganization}).

2. Zvolte Azure DevOps, nastavení organizace.

   

3. Vyberte fondy agentů.

   

Pokud jste členem projektového týmu, vytvoříte a spravujete fondy agentů na kartě Fondy agentů v nastavení projektu.

Přejděte do projektu a zvolte Nastavení projektu, Fondy agentů.

Pokud chcete odstranit fond, přejděte do seznamu Fondů agentů, zvolte Další možnosti, Odstranit.

Rozhraní příkazového řádku Azure DevOps

Seznam fondů agentů | Zobrazení podrobností o fondu agentů | Seznam front agentů | Zobrazení podrobností o frontě agenta

Poznámka:

V tuto chvíli můžete pomocí Azure CLI zobrazit informace o fondech agentů a frontách, ale nemůžete je upravovat.

Pokud používáte příkazy poprvé az devops pipelines , přečtěte si téma Začínáme s Azure DevOps CLI.

Seznam fondů agentů

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

Parametry

• action: Filtrujte seznam s povolenou akcí uživatele. Přijaté hodnoty: správa, žádné, použití
• detect: Automaticky rozpozná organizaci. Přijaté hodnoty: false, true
• org nebo organizace: Adresa URL organizace Azure DevOps. Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
• název fondu: Vyfiltrujte seznam s odpovídajícím názvem fondu.
• typ fondu: Filtrujte seznam s typem fondu. Přijaté hodnoty: automatizace, nasazení

Příklad

Následující příklad uvádí všechny fondy ve formátu tabulky. V tomto příkladu se používá následující výchozí konfigurace: 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

Zobrazení podrobností fondu agentů

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

Parametry

• ID nebo ID fondu: (Povinné) ID fondu pro výpis podrobností.
• action: Filtrujte seznam s povolenou akcí uživatele. Přijaté hodnoty: správa, žádné, použití
• detect: Automaticky rozpozná organizaci. Přijaté hodnoty: false, true
• org nebo organizace: Adresa URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.

Příklad

Následující příklad zobrazí podrobnosti o hostovaném fondu Windows 2019 s VS2019. V tomto příkladu se používá následující výchozí konfigurace: 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
}

Můžete také použít --output table , aby se vrátily stejné informace jako příkaz list .

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

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

Seznam front agentů

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

Parametry

• action: Filtrujte seznam s povolenou akcí uživatele. Přijaté hodnoty: správa, žádné, použití
• detect: Automaticky rozpozná organizaci. Přijaté hodnoty: false, true
• org nebo organizace: Adresa URL organizace Azure DevOps. Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
• project nebo p: Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu.
• queue-name: Vyfiltrujte seznam podle odpovídajícího regulárního výrazu pro název fronty, např. ubuntu pro frontu s názvem "Hosted Ubuntu 1604".

Příklad

Následující příklad uvádí všechny fronty ve formátu tabulky. V tomto příkladu se používá následující výchozí konfigurace: 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

Zobrazení podrobností fronty agenta

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

Parametry

• ID nebo ID fronty: ID fronty agenta, o které chcete získat informace.
• action: Filtrujte seznam s povolenou akcí uživatele. Přijaté hodnoty: správa, žádné, použití
• detect: Automaticky rozpozná organizaci. Přijaté hodnoty: false, true
• org nebo organizace: URL organizace Azure DevOps Výchozí organizaci můžete nakonfigurovat pomocí příkazu az devops configure -d organization=ORG_URL. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo vyzvednuto prostřednictvím konfigurace Gitu. Příklad: https://dev.azure.com/MyOrganizationName/.
• projekt nebo p: Název nebo ID projektu. Výchozí projekt můžete nakonfigurovat pomocí az devops configure -d project=NAME_OR_ID. Vyžaduje se, pokud není nakonfigurované jako výchozí nebo získáno z konfigurace Gitu.

Příklad

Následující příklad zobrazuje podrobnosti fronty pro hostovaný systém Windows 2019 s VS2019. V tomto příkladu se používá následující výchozí konfigurace: 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"
}

Pooly se používají ke spouštění úloh. Zjistěte více o specifikaci poolů pro úlohy.

Pokud máte spoustu samostatně hostovaných agentů určených pro různé týmy nebo účely, můžete zvážit vytvoření dalších skupin, jak je vysvětleno níže.

Vytvoření fondů agentů

Tady je několik typických situací, kdy můžete chtít vytvořit fondy agentů na vlastním serveru:

• Jste členem projektu a chcete použít sadu počítačů vlastněných vaším týmem pro spouštění úloh sestavení a nasazení. Nejprve se ujistěte, že máte oprávnění k vytváření fondů v projektu, a to tak, že v nastavení projektu vyberete Zabezpečení na stránce Fondy agentů. Abyste mohli vytvářet nové fondy, musíte mít roli Správce . Dále vyberte Přidat fond a vyberte možnost pro vytvoření nového fondu. Nakonec nainstalujte a nakonfigurujte agenty tak, aby byly součástí tohoto fondu agentů.

• Jste členem týmu infrastruktury a chcete vytvořit fond agentů pro všechny projekty. Nejdřív se ujistěte, že máte oprávnění k vytváření fondů v projektu, a to tak, že v nastavení organizace vyberete Zabezpečení na stránce Fondy agentů. Dále vytvořte nový fond agentů a vyberte možnost automatického zřízení tohoto fondu agentů ve všech projektech při vytváření fondu. Toto nastavení zajišťuje, že všechny projekty mají přístup k tomuto fondu agentů. Nakonec nainstalujte a nakonfigurujte agenty tak, aby byly součástí tohoto fondu agentů.

• Chcete sdílet sadu počítačů agentů s více projekty, ale ne se všemi. Nejprve přejděte do nastavení jednoho z projektů, přidejte fond agentů a vyberte možnost pro vytvoření nového fondu na úrovni organizace. Dále přejděte na každý z ostatních projektů a vytvořte v každém z nich fond a vyberte možnost Použít existující fond agentů z organizace. Nakonec nainstalujte a nakonfigurujte agenty tak, aby byly součástí fondu sdílených agentů.

Zabezpečení fondů agentů

Pochopení, jak funguje zabezpečení pro fondy agentů, vám pomůže řídit sdílení a používání agentů.

Role jsou definovány v jednotlivých fondech agentů a členství v těchto rolích určuje, jaké operace můžete ve fondu agentů provádět.

Nastavení zabezpečení na úrovni organizace

Role v rámci fondu agentů v nastavení organizace	Účel
Čtenář	Členové této role můžou zobrazit fond agentů i agenty. Obvykle ho používáte k přidání operátorů, kteří jsou zodpovědní za monitorování agentů a jejich stavu.
Účet služby	Členové této role můžou fond agentů organizace použít k vytvoření fondu agentů projektu v projektu. Pokud budete postupovat podle výše uvedených pokynů pro vytváření nových fondů agentů projektu, obvykle sem nemusíte přidávat žádné členy.
Správce	Kromě všech výše uvedených oprávnění můžou členové této role zaregistrovat nebo zrušit registraci agentů z fondu agentů organizace. Při vytváření fondu agentů v projektu můžou také odkazovat na agenturní fond organizace. Konečně můžou také spravovat členství pro všechny role poolu agentů organizace. Uživatel, který vytvořil fond agentů organizace, se automaticky přidá do role Správce pro tento fond.

Uzel Všechny agentní fondy na kartě Fondy agentů slouží k řízení bezpečnosti všech fondů agentů organizace. Členství v rolích pro jednotlivé fondy agentů organizace se automaticky dědí z uzlu 'Všechny fondy agentů'. Správci TFS a Azure DevOps Serveru jsou ve výchozím nastavení také správci uzlu Všechny fondy agentů při použití TFS nebo Azure DevOps Serveru.

Nastavení zabezpečení na úrovni projektu

Role jsou také definovány v každém fondu agentů projektu a členství v těchto rolích řídí, jaké operace můžete ve fondu agentů provádět na úrovni projektu.

Role ve fondu agentů v nastavení projektu	Účel
Čtenář	Členové této role mohou zobrazit fond agentů projektu. Obvykle ho použijete k přidání operátorů, kteří jsou zodpovědní za monitorování úloh sestavení a nasazení v daném fondu agentů projektu.
Uživatel	Členové této role můžou při návrhu pipeline používat fond agentů tohoto projektu.
Správce	Kromě všech výše uvedených operací můžou členové této role spravovat členství pro všechny role fondu agentů projektu. Uživatel, který fond vytvořil, se automaticky přidá do role Správce pro tento fond.

Oprávnění potrubí

Oprávnění kanálu určují, které kanály YAML mají povolení k používání fondu agentů. Oprávnění kanálu neomezují přístup z klasických kanálů.

Můžete si vybrat některé z následujících možností:

• Otevření přístupu pro všechny kanály pro použití fondu agentů z dalších možností v pravém horním rohu oddílu Oprávnění kanálu na kartě zabezpečení fondu agentů.

• Uzamkněte fond agentů a povolte jeho použití jenom vybraným kanálům YAML. Pokud jakýkoli jiný kanál YAML odkazuje na fond agentů, vyvolá se žádost o autorizaci, kterou musí schválit správce fondu agentů. Tím se neomezuje přístup z klasických kanálů.

Oprávnění kanálu pro fond agentů Azure Pipelines nelze nakonfigurovat, protože fond je ve výchozím nastavení přístupný pro všechny kanály.

Akce Zabezpečení na kartě Fondy agentů slouží k řízení zabezpečení všech fondů agentů projektu v projektu. Role jednotlivých fondů agentů projektu se automaticky dědí z nastavení, které zde definujete. Ve výchozím nastavení se do role Správce všech fondů agentů přidají následující skupiny: Správci sestavení, Správci verzí, Správci projektů.

Často kladené dotazy

Pokud neplánuji časové období údržby, kdy agenti provedou údržbu?

Pokud není naplánováno žádné časové okno, agenti v tomto fondu nespustí úlohu údržby.

Co je úloha údržby?

Fondy agentů můžete nakonfigurovat tak, aby pravidelně uklízely zastaralé pracovní adresáře a úložiště. Tím by se mělo snížit riziko, že agentům dojde místo na disku. Úlohy údržby se konfigurují na úrovni organizace v nastavení fondu agentů.

Konfigurace nastavení úlohy údržby:

1. Přihlaste se ke své organizaci (https://dev.azure.com/{yourorganization}).

2. Zvolte Azure DevOps, nastavení organizace.

   

3. Zvolte fondy agentů.

   

Zvolte požadovaný fond a zvolte Nastavení pro konfiguraci nastavení úlohy údržby pro tento fond agentů.

Důležité

Ke konfiguraci nastavení úlohy údržby musíte mít oprávnění Spravovat fronty sestavení. Pokud nevidíte kartu Nastavení ani kartu Historie údržby, nemáte toto oprávnění, které je ve výchozím nastavení uděleno roli Správce . Další informace naleznete v tématu Zabezpečení fondů agentů.

Nakonfigurujte požadovaná nastavení a zvolte Uložit.

Výběrem možnosti Historie údržby zobrazíte historii úloh údržby pro aktuální fond agentů. Můžete si stáhnout a zkontrolovat protokoly a podívat se na provedené kroky a akce čištění.

Údržba se provádí na fond agentů, ne na počítač; takže pokud máte na jednom počítači více fondů agentů, může dojít k problémům s místem na disku.

Úloha údržby mého samostatně hostovaného fondu agentů vypadá, že uvízla. Proč?

Úloha údržby obvykle uvázne, když čeká na spuštění u agenta, který už není ve fondu agentů. K tomu dochází například v případě, že je agent záměrně převedený do offline režimu nebo má problémy s komunikací.

Úlohy údržby, které byly zařazeny do fronty, budou čekat na spuštění sedm dní. Poté se automaticky nastaví do stavu selhání, pokud se nespustí. Tento časový limit nelze změnit.

Tento sedmidenní limit se liší od nastavení časového limitu úlohy údržby. Ten řídí maximální počet minut, které může agent strávit údržbou. Časovač se spustí, když se úloha zahájí, ne když je zařazena do fronty u agenta.

Pokouším se vytvořit pool agentů projektu, který používá existující pool agentů organizace, ale ovládací prvky jsou deaktivované. Proč?

V dialogovém okně Vytvořit fond agentů projektu nemůžete použít existující fond agentů organizace, pokud na něj už odkazuje jiný fond agentů projektu. Na každý fond agentů organizace může odkazovat jenom jeden fond agentů projektu v dané kolekci projektů.

Nejde mi vybrat fond hostovaný Microsoftem a zařadit build do fronty. Jak to můžu vyřešit?

Požádejte vlastníka vaší organizace Azure DevOps, aby vám udělil oprávnění k používání příslušného fondu. Viz Zabezpečení fondů agentů.

Potřebuji více hostovaných prostředků sestavení. Co mám dělat?

A: Pool Azure Pipelines poskytuje všem organizacím Azure DevOps agenty pro sestavení hostované v cloudu a bezplatné minuty sestavení každý měsíc. Pokud potřebujete více prostředků sestavení hostovaných Microsoftem nebo potřebujete paralelně spouštět další úlohy, můžete:

• Hostování vlastních agentů na infrastruktuře, kterou spravujete
• Nákup dalších paralelních úloh