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

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

Poznámka

V Microsoft Team Foundation Server (TFS) 2018 a předchozích verzích se kanály sestavení a verze označují jako definice, spuštění se nazývají buildy, připojení služeb se nazývají koncové body služby, fáze se nazývají prostředí a úlohy se nazývají fáze.

Fond agentů je kolekce agentů. Místo správy jednotlivých agentů uspořádáte agenty do fondů agentů. V TFS jsou fondy vymezeny na celý server; takže můžete sdílet fond agentů napříč kolekcemi projektů a projekty.

Fronta agenta poskytuje přístup k fondu agentů v rámci projektu. Při vytváření kanálu buildu nebo verze určíte, kterou frontu používá. Fronty jsou vymezeny na váš projekt v TFS 2017 a novějším, takže je můžete používat jenom v kanálech sestavení a verzí v rámci projektu.

Pokud chcete sdílet fond agentů s více projekty, v každém z těchto projektů vytvoříte frontu agenta odkazující na stejný fond agentů. I když více front napříč projekty může používat stejný fond agentů, více front v rámci projektu nemůže použít stejný fond agentů. Každá fronta agenta může také používat pouze jeden fond agentů.

Architektura systému sestavení TFS 2017 a TFS 2018

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 zadáte fond, ve kterém se kanál spustí. Když kanál spustíte, spustí se v 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.

V Azure DevOps Server jsou fondy agentů vymezeny na celý server, abyste mohli sdílet počítače agentů napříč projekty a kolekcemi.

Poznámka

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

Fondy agentů vytvoříte a spravujete na kartě Fondy agentů v nastavení správce.

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

  1. Zvolte Azure DevOps, nastavení organizace.

    Zvolte nastavení organizace.

  2. Zvolte fondy agentů.

    Zvolte kartu Fondy agentů.

  1. Zvolte Azure DevOps, Nastavení kolekce.

    Zvolte nastavení kolekce.

  2. Zvolte fondy agentů.

    Zvolte fondy agentů.

  1. Zvolte Azure DevOps, Nastavení kolekce.

    Nastavení kolekce, 2019.

  2. Zvolte fondy agentů.

    Zvolte fondy agentů, 2019.

  1. Přejděte do projektu a zvolte Nastavení (ikona ozubeného kola) >Fronty agentů.

    Zvolte Nastavení, fronty agentů, 2018.

  2. Zvolte Spravovat fondy.

    Zvolte Spravovat fondy, 2018.

Fronty agentů vytvoříte a spravujete z karty front agentů v nastavení projektu.

Pokud jste členem týmu projektu, vytvoříte a spravujete fronty agentů z karty fondy agentů v nastavení projektu.

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

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

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

Přejděte do projektu a zvolte Nastavení projektu, fondy agentů (2020).

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

Přejděte k projektu a zvolte Nastavení projektu, fondy agentů (2019).

Přejděte do projektu a zvolte Nastavení (ikona ozubeného kola) >Fronty agentů.

Zvolte nastavení, fronty agentů, TFS 2018.

Výchozí fondy agentů

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

  • Fond hostovaný službou Azure Pipelines s různými imagemi windows, Linuxu a macOS Úplný seznam dostupných imagí a jejich nainstalovaného softwaru najdete v agentech hostovaných Microsoftem.

    Poznámka

    Hostovaný fond Azure Pipelines nahrazuje předchozí hostované fondy, které mají názvy mapované 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 nového hostovaného fondu Azure Pipelines. Za určitých okolností se můžou stále zobrazovat staré názvy fondů, ale na pozadí se hostované úlohy spouští pomocí fondu Azure Pipelines. Další informace najdete v poznámkách k verzi jednoho hostovaného fondu 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živatele v hostovaných fondech. To umožňuje každému přispěvateli v projektu vytvářet a spouštět kanály pomocí agentů hostovaných Microsoftem.

Určení fondu v kanálu

Kanály YAML jsou podporované v Azure DevOps Server 2019 a novějších.

Pokud chcete vybrat agenta hostovaného Microsoftem z fondu Azure Pipelines ve vašem kanálu Azure DevOps Services YAML, 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 v schématu YAML pro fondy.

Správa fondů a front

Fondy agentů vytvoříte a spravujete na kartě Fondy agentů v nastavení správce.

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

  1. Zvolte Azure DevOps, nastavení organizace.

    Zvolte nastavení organizace.

  2. Zvolte fondy agentů.

    Zvolte kartu Fondy agentů.

  1. Zvolte Azure DevOps, Nastavení kolekce.

    Zvolte nastavení kolekce.

  2. Zvolte fondy agentů.

    Zvolte fondy agentů.

  1. Zvolte Azure DevOps, Nastavení kolekce.

    Nastavení kolekce, 2019.

  2. Zvolte fondy agentů.

    Zvolte fondy agentů, 2019.

  1. Přejděte do projektu a zvolte Nastavení (ikona ozubeného kola) >Fronty agentů.

    Zvolte Nastavení, fronty agentů, 2018.

  2. Zvolte Spravovat fondy.

    Zvolte Spravovat fondy, 2018.

Fronty agentů vytvoříte a spravujete z karty front agentů v nastavení projektu.

Pokud jste členem týmu projektu, vytvoříte a spravujete fronty agentů z karty fondy agentů v nastavení projektu.

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

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

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

Přejděte do projektu a zvolte Nastavení projektu, fondy agentů (2020).

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

Přejděte do projektu a zvolte Nastavení projektu, fondy agentů (2019).

Přejděte do projektu a zvolte Nastavení (ikona ozubeného kola) >Fronty agentů.

Zvolte nastavení, fronty agentů, TFS 2018.

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, možná budete chtít vytvořit další fondy, jak je vysvětleno níže.

Vytvoření fondů agentů

Tady jsou některé typické situace, 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 výběrem možnosti Zabezpečení na stránce Fondy agentů v nastavení projektu. Abyste mohli vytvářet nové fondy, musíte mít roli Správce . Dále vyberte Přidat fond a vyberte možnost vytvořit nový fond na úrovni organizace. 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 jste členem skupiny ve všech fondech agentů s rolí Správce , a to tak, že přejdete na stránku fondů agentů v nastavení organizace. Dále vytvořte nový fond agentů a vyberte možnost automatického zřizování odpovídajících fondů 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í pro jeden z projektů, přidejte fond agentů a vyberte možnost vytvořit nový fond na úrovni organizace. Pak přejděte k jednotlivým dalším projektům 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ů.

  • 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 jste členem skupiny ve všech fondech s rolí Správce . V nastavení projektu vytvořte nový fond agentů projektu a vyberte možnost Vytvořit nový fond agentů organizace. V důsledku toho se vytvoří fond agentů na úrovni organizace i projektu. 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. Nejprve se ujistěte, že jste členem skupiny ve všech fondech s rolí Správce . Dále v nastavení správce vytvořte fond agentů nové organizace a vyberte možnost automatického zřizování odpovídajících fondů agentů projektu ve všech projektech při vytváření fondu. Toto nastavení zajistí, že všechny projekty mají fond odkazující na fond agentů organizace. Systém vytvoří fond pro existující projekty a v budoucnu to provede pokaždé, když se vytvoří nový projekt. Nakonec nainstalujte a nakonfigurujte agenty tak, aby byly součástí tohoto fondu agentů.

  • Chcete sdílet sadu počítačů agentů s několika projekty, ale ne všechny. Nejprve vytvořte fond agentů projektu v jednom z projektů a vyberte možnost Vytvořit nový fond agentů organizace při vytváření tohoto fondu. Pak přejděte na každý z ostatních projektů a vytvořte fond v každém z nich a vyberte možnost Použít existující fond agentů organizace. Nakonec nainstalujte a nakonfigurujte agenty tak, aby byly součástí fondu sdílených agentů.

Zabezpečení fondů agentů

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

Role jsou definovány pro každý fond agentů a členství v těchto rolích řídí operace, které můžete ve fondu agentů provádět.

Role ve fondu agentů v nastavení organizace Účel
Čtenář Členové této role můžou zobrazit fond agentů i agenty. Obvykle to používáte k přidání operátorů, kteří jsou zodpovědní za monitorování agentů a jejich stavu.
Service Account Členové této role můžou fond agentů organizace použít k vytvoření fondu agentů projektu v projektu. Pokud při vytváření nových fondů agentů projektu dodržujete výše uvedené pokyny, nemusíte sem obvykle 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 také spravovat členství pro všechny role fondu agentů organizace. Uživatel, který vytvořil fond agentů organizace, se automaticky přidá do role Správce 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 uzlu Všechny fondy agentů. Při použití sady TFS nebo Azure DevOps Server jsou správci TFS a Azure DevOps Server také správci uzlu Všechny fondy agentů.

Role jsou také definovány pro každý fond agentů projektu a členství v těchto rolích určují, jaké operace můžete s fondem agentů provádět na úrovni projektu.

Role ve fondu agentů v nastavení projektu Účel
Čtenář Členové této role můžou zobrazit fond agentů projektu. Obvykle to používáte k přidání operátorů, které 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 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ý fond vytvořil, se automaticky přidá do role Správce pro tento fond.

Uzel Všechny fondy agentů na kartě Fondy agentů slouží k řízení zabezpečení všech fondů agentů projektu v projektu. Členství v rolích pro jednotlivé fondy agentů projektu se automaticky dědí z uzlu Všechny fondy agentů. 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ů.

Akce Zabezpečení na kartě Fondy agentů slouží k řízení zabezpečení všech fondů agentů projektu v projektu. Členství v rolích pro jednotlivé fondy agentů projektu se automaticky dědí z toho, co tady 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ů.

Časté otázky

Pokud neplánuji časové období údržby, kdy budou agenti spouštět údržbu?

Pokud není naplánované žádné okno, agenti v daném fondu nebudou spouštět úlohu údržby.

Co je úloha údržby?

Fondy agentů můžete nakonfigurovat tak, aby pravidelně uklidily zastaralé pracovní adresáře a úložiště. To by mělo snížit potenciál pro agenty, kteří mají nedostatek místa na disku. Úlohy údržby se konfigurují na úrovni kolekce projektů nebo organizace v nastavení fondu agentů.

Konfigurace nastavení úlohy údržby:

  1. Zvolte Azure DevOps, nastavení organizace.

    Zvolte nastavení organizace.

  2. Zvolte fondy agentů.

    Zvolte kartu Fondy agentů.

  1. Zvolte Azure DevOps, Nastavení kolekce.

    Zvolte nastavení kolekce.

  2. Zvolte fondy agentů.

    Zvolte fondy agentů.

  1. Zvolte Azure DevOps, Nastavení kolekce.

    Nastavení kolekce, 2019.

  2. Zvolte fondy agentů.

    Zvolte fondy agentů, 2019.

  1. Přejděte do projektu a zvolte Nastavení (ikona ozubeného kola) >Fronty agentů.

    Zvolte Nastavení, fronty agentů, 2018.

  2. Zvolte Spravovat fondy.

    Zvolte Spravovat fondy, 2018.

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

Důležité

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

Nastavení úlohy údržby

Nastavení úlohy údržby pro TFS

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ů. Protokoly si můžete stáhnout a zkontrolovat a zobrazit kroky čištění a provedené akce.

Historie úloh údržby

Ú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ůžete stále narazit na problémy s místem na disku.

Úloha údržby mého fondu agentů hostovaných v místním prostředí vypadá jako zablokovaná. Proč?

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

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

Sedmidenní limit se liší od nastavení časového limitu úlohy údržby . Druhý určuje maximální počet minut, které může agent strávit údržbou. Časovač se spustí při spuštění úlohy, ne v případě, že je úloha zařazena do fronty agenta.

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 již odkazuje jiný fond agentů projektu. Každý fond agentů organizace může odkazovat pouze na jeden fond agentů projektu v dané kolekci projektů.

Nemůžu vybrat fond hostovaný Microsoftem a nemůžu zařadit sestavení do fronty. Návody to opravit?

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

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

A: Fond Azure Pipelines poskytuje všem organizacím Azure DevOps agenty sestavení hostované v cloudu a minutám bezplatného 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 provést následující: