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í kanálu určíte fond, ve kterém se kanál spouští. Když kanál spustíte, spustí se na agentu z tohoto fondu, který splňuje požadavky kanálu.

Ve službě Azure Pipelines jsou fondy vymezeny na celou organizaci; abyste mohli sdílet počítače agentů napříč projekty.

Poznámka:

Úlohy fondu agentů spouští úlohu v jednom agentu. Pokud potřebujete spustit úlohu na všech agentech, jako je skupina nasazení pro kanály verze Classic, přečtěte si téma Zřizování skupin nasazení.

Pokud jste správcem organizace, vytvoříte a spravujete fondy agentů 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. Zvolte 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ů.

Výchozí fondy agentů

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

• Výchozí fond: Použijte ho k registraci agentů v místním prostředí, které jste nastavili.

• Hostovaný fond Azure Pipelines s různými imagemi 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, se automaticky přesměrují na správnou image v novém hostovaném fondu Azure Pipelines. Za některých okolností se stále můžou zobrazovat staré názvy fondů, ale na pozadí se hostované úlohy spouštějí pomocí fondu Azure Pipelines. Další informace najdete ve zprávě k vydání verze pro jeden hostovaný fond z poznámky k verzi z července 1 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.

Určení fondu v kanálu

YAML

Pokud chcete zvolit agenta hostovaného Microsoftem z fondu Azure Pipelines v kanálu YAML služby Azure DevOps Services, zadejte název image pomocí popisku image 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.

Použití privátního fondu bez požadavků:

pool: MyPool

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

Klasické

Pokud chcete zvolit fond a agenta v klasickém editoru, přejděte do nastavení kanálu, vyberte požadovaný fond agentů a potom z rozevíracího seznamu Specifikace agenta 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

Prohlížeč

Pokud jste správcem organizace, vytvoříte a spravujete fondy agentů 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. Zvolte 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ů.

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

Zobrazení seznamu fondů | agentů – Zobrazení podrobností o | fondu 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 ne o jejich úpravách.

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

Výpis 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
• organizace 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
• organizace 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 fondu hostovaného Windows 2019 s fondem 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

Výpis 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
• organizace 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: Name or ID of the project. 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 s odpovídajícími regulárními výrazy názvu fronty, například 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 pro získání informací o.
• 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
• organizace 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: Name or ID of the project. 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.

Příklad

Následující příklad zobrazuje podrobnosti fronty pro hostovaný Windows 2019 s frontou 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"
}

Fondy se používají ke spouštění úloh. Přečtěte si o zadávání fondů pro úlohy.

Pokud máte spoustu agentů v místním prostředí určených pro různé týmy nebo účely, můžete chtít vytvořit další fondy, 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ů v místním prostředí:

• 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áva istrator. 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 nastavit fond agentů pro použití ve všech projektech. 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 všechny. 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 ve 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ů projektu v projektu můžou také odkazovat na fond agentů organizace. Nakonec můžou spravovat členství pro všechny role fondu agentů organizace. Uživatel, který vytvořil fond agentů organizace, se automaticky přidá do role Správa istrator pro tento fond.

Uzel Všechny fondy agentů na kartě Fondy agentů slouží k řízení zabezpečení všech fondů agentů organizace. Členství v rolích pro jednotlivé fondy agentů organizace se automaticky dědí z uzlů 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ů, které jsou zodpovědné za monitorování úloh sestavení a nasazení v daném fondu agentů projektu.
Uživatelská	Členové této role můžou při vytváření kanálů používat fond agentů 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ý vytvořil fond, se automaticky přidá do role Správa istrator pro tento fond.

Oprávnění kanálu

Řízení oprávnění kanálu, které kanály YAML mají oprávnění používat fond 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, která musí být schválena fondem agentů Správa istrator. 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. Členství rolí pro jednotlivé fondy agentů projektu se automaticky dědí z toho, co tady definujete. Ve výchozím nastavení se do role Správa istratoru všech fondů agentů přidávají následující skupiny: Build Správa istrators, Release Správa istrators, Project Správa istrators.

Často kladené dotazy

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

Pokud není naplánované žádné okno, agenti v daném 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ěl snížit potenciál, že agenti na disku najdou místo. Ú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í a nakonfigurujte 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í nebo kartu Historie údržby, nemáte toto oprávnění, které je ve výchozím nastavení uděleno Správa istrator role. 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 fondu agentů v místním prostředí vypadá zablokovaná. Proč?

Úloha údržby se obvykle zablokuje, když čeká na spuštění na agentovi, 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í při spuštění úlohy, ne když je úloha zařazena do fronty v agentovi.

Pokouším se vytvořit fond agentů projektu, který používá existující fond agentů organizace, ale ovládací prvky jsou neaktivní. 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: Fond Azure Pipelines poskytuje všem organizacím Azure DevOps agenty sestavení hostované v cloudu a minuty bezplatných 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