Sdílet prostřednictvím

Nasazení a konfigurace agentů sestavení

  • Článek

Chcete-li použít Team Foundation Build, váš tým musí mít alespoň jednoho agenta sestavení pro vykonání práce náročné na procesor vašeho procesu sestavení.

Servery dvě sestavení

Každý agent sestavení je vyhrazen a řízen jedním kontrolérem sestavení.Agenty sestavení lze hostovat na stejném serveru sestavení, který je hostitelem jejich kontroléru sestavení. Není to však nutné a v některých případech lze potřeby vašeho týmu naplnit pomocí jediného serveru sestavení, který bude hostitelem řadiče sestavení řídícím agenty sestavení na více serverech sestavení.

Agent sestavení provede kroky procesu sestavení, které jsou obsaženy v aktivitě AgentScope.Obvykle tyto kroky zahrnují získávání souborů ze správy verzí, zřizování pracovního prostoru, kompilaci kódu, spouštění testů a slučování souborů zpět do správy verzí.

Přesvědčte se, zda má server sestavení hostící vaše agenty sestavení dostatečnou úložnou a výpočetní kapacitu, aby odpovídala velikosti a složitosti kódové základny a testů v kolekci týmových projektů.Obvykle byste neměli hostit více než jednoho agenta sestavení na jádro procesoru v serveru sestavení.Můžete také zvýšit výkon tím, že vyhradíte jeden fyzický pevný disk pro pracovní adresář každého agenta sestavení.

Tip

Pokud je vaše kolekce týmového projektu hostována službou Visual Studio Online a potřeby vašeho týmu mohou být splněny jediným standardním agentem sestavení, můžete použít Kontrolér hostovaného sestavení místo nasazení vlastního agenta sestavení.

Požadovaná oprávnění

Musíte být členem skupiny Administrators systému Windows na serveru sestavení a členem skupiny Správci kolekcí sestavení projektů v kolekci týmového projektu.Viz téma Oprávnění v prostředí Team Foundation Server.

Co chcete udělat?

Vytvořit nebo změnit agent sestavení

Tvorba nebo změna agenta sestavení ze serveru sestavení

  1. Přihlaste se k serveru sestavení, který chcete konfigurovat.

  2. Pomocí nabídky Start systému Windows spusťte Konzoli pro správu Team Foundation.

    Objeví se Konzola pro správu serveru Team Foundation.

  3. V podokně stromu konzoly pro správu Team Foundation rozbalte název serveru a zvolte uzel Konfigurace sestavení.

    V podokně obsah se zobrazí informace o sestavení serveru.

    Pokud se zobrazí zpráva Konfigurace nainstalované funkceNakonfigurovat nainstalované funkce, viz Nasazení serveru sestavení.

  4. Na stránce Konfigurace sestavení:

    • Chcete-li vytvořit nového agenta sestavení, zvolte možnost Nový agent.

    • Úprava existujícího agenta sestavení

      Agent sestavení

      zvolte Vlastnosti.

    Zobrazí se dialogové okno Vlastnosti agenta sestavení.

Změna agenta sestavení z aplikace Visual Studio

  1. V aplikaci Visual Studio v Průzkumníkovi týmu:

    1. Pokud již nejste připojeni k týmovému projektu v kolekci týmových projektů, připojte se k týmovému projektu.

    2. Vyberte Ikona Domovská stránkaDomů a pak zvolte Ikona sestaveníSestavení.

  2. Na stránce Sestavení klikněte na možnost Akce a poté na možnost Správa kontrolérů sestavení.

    Zobrazí se dialogové okno Správa řadičů sestavení.

    Dialogové okno Spravovat sestavení řadiče

  3. Vyberte agenta sestavení, kterého chcete upravit, a klikněte na tlačítko Vlastnosti.

    Zobrazí se dialogové okno Vlastnosti agenta sestavení.

Vytvořit dialogové okno Vlastnosti agenta

Zobrazovaný název > Popis: Zadejte název a popis umožňující členům týmu snadno identifikovat agenta sestavení.

Kontrolér: vyberte kontrolér sestavení, pomocí kterého chcete řídit tohoto agenta sestavení.Řadič sestavení může běžet na stejném serveru sestavení jako tento agent sestavení nebo na jiném serveru sestavení.

Podrobnosti o konfiguraci agenta sestavení naleznete v níže uvedených částech.

Instalace sady Visual Studio a dalšího softwaru umožňujícího kompilaci a další možnosti

Je třeba na agenta sestavení nainstalovat verzi sady Visual Studio, kterou používá váš tým ve vývojových počítačích.Viz téma Instalace sady Visual Studio.Také musíte nainstalovat další software a součásti, které jsou nainstalovány ve vývojových počítačích a které jsou nutné k vytvoření aplikace.

Určete pracovní adresář

Můžete určit pracovní adresář, který agent sestavení používá ke čtení nebo zápisu do souborů.Například zdrojové soubory jsou zkopírovány do podsložek v této složce a binární soubory jsou vytvořeny a uloženy v jiné podsložce v této složce.

Tip

Můžete zvýšit výkon tím, že vyhradíte jeden fyzický pevný disk pro pracovní adresář každého agenta sestavení.

Použijte tokeny pracovního adresáře

Ačkoliv je možné zadat literální cestu pro vlastnost Pracovní adresář (například c:\temp\build\), jednodušší a trvanlivější přístup je použití tokenů pro určení cesty.Můžete použít dva typy tokenů:

  • Proměnné prostředí
    Proměnné prostředí obsahují informace o prostředí systému a uživateli, který je přihlášen.Nejtypičtější použít proměnnou je SYSTEMDRIVE, ale v některých situacích můžete také použít proměnné, jako USERNAME nebo HOMEPATH.

    Tip

    Chcete-li zobrazit seznam proměnných prostředí na serveru sestavení, otevřete příkazový řádek a zadejte set.

  • Proměnné systému Team Foundation Build
    Můžete používat následující proměnné v pracovním adresáři agenta sestavení:

    • $(BuildAgentId): Celé automaticky generované číslo, které jednoznačně identifikuje agenta sestavení v kolekci týmu projektu.

    • $(BuildAgentName): Zobrazovaný název agenta sestavení.

    • $(BuildDefinitionId): Celé automaticky generované číslo, které jednoznačně identifikuje definici sestavení v kolekci týmu projektu.

    • $(BuildDefinitionPath): Název týmového projektu a název definice sestavení oddělené zpětným lomítkem.

Přiklad pracovního adresáře

Například máte agenta sestavení s názvem BuildBot3.Jsou definována dvě sestavení, která jsou označovány jako NightlyBuild a WeeklyBuild v týmu projektu, který se nazývá CoolApp.Do pole Pracovní adresář zadejte následující hodnotu: $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath).V důsledku toho agent sestavení BuildBot3 vytváří a používá následující dva pracovní adresáře:

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Ujistěte se, že cesta do pracovního adresáře není příliš dlouhá

Pracovní adresář, které zadáte, nesmí způsobit, že agent sestavení vytvoří fyzickou cestu delší než 259 znaků.Jinak vaše sestavení může selhat a protokolovat tuto chybu: TF10128: The pathPhysicalPath contains more than the allowed 259 characters. Type or select a shorter path.

Chcete-li tento problém vyřešit, zadejte pracovní adresář, který má za následek kratší fyzickou cestu.Můžete použít například $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), což bude mít za následek vznik pracovního adresáře, jako například c:\bld\3\2\.

Podadresáře vytvořené v pracovním adresáři

Agent sestavení vytváří a pracuje v následujících podadresářích pod touto cestou.

Podadresář

Slouží k uložení souborů...

Sources

Číst podle agenta sestavení, například jako zdrojové soubory.Zadejte soubory, které stáhne v nastavení Pracovní prostor pro každou definici sestavení.Viz téma Práce s pracovními prostory sestavení.

Binaries

Kompilováno pomocí agenta sestavení, jako například soubory kompilované aplikace.

TestResults

Vytvořeno libovolnými testy, které agent spustil.

Povolit spuštění testů agentem sestavení

Můžete definovat proces sestavení, který provádí jeden nebo více automatizovaných testovacích spuštění.

Důležitá poznámkaDůležité

Různé druhy testů a testovacích operací vyžadují, abyste instalovali v agentovi sestavení stejnou verzi sady Visual Studio, kterou používá váš tým v počítačích pro vývoj.Viz téma Instalace sady Visual Studio.

Agent sestavení může spustit:

Přiřadit značky představující možnosti nebo účely agenta sestavení

S narůstajícím rozsahem systému sestavení, můžete definovat specializované agenty sestavení.Kdykoli má agent sestavení zvláštní schopnosti nebo je určen pro konkrétní druh využití, byste měli tomuto agentovi přiřadit jednu nebo více značek.Tímto způsobem, když člen týmu vytvoří definici sestavení, která vyžaduje určitý druh agenta sestavení, může určit značky v definicích sestavení.

Můžete přiřadit značky z dialogového okna Vlastnosti agenta sestavení, popsané výše.Pak můžete použít značky u definic sestavení.

Následující tabulka nabízí příklady názvy tagů a možností agenta sestavení, které by mohly představovat.

Můžete použít následující značku...

Určení agenta sestavení, který umí…

x86

Kompilace 32bitových aplikací

x64

Kompilovat 64bitové aplikace

bvt

Spuštění testů BVT, které pracují ve vašem nočním sestavení BVT.

WindowsStore

Sestavit a otestovat aplikaci pro Windows Store.

IIS

Kompilace webové aplikace ASP.NET a její následné fázování a hostování v počítači, ve kterém je spuštěn agent sestavení.

interaktivní

Provede úlohy vyžadující agenta na sestavení serveru, který běží v interaktivním režimu.

U agenta sestavení můžete použít více než jednu značku.Můžete například vytvořit agenta sestavení se značkou „x86“ a „Vydání“ a označit tak agenta, který je nastaven pro kompilaci konfigurace Vydání 32bitové aplikace.

Pokud spustíte více agentů sestavení na stejném serveru sestavení, pravděpodobně budou mít všichni stejné schopnosti.Proto pravděpodobně můžete použít stejné značky na všechny agenty sestavení na tomto serveru sestavení.

Odebrat agenta sestavení

  1. V sadě Visual Studio otevřete dialogové okno Správa kontrolérů sestavení podle pokynů výše v části Vytvořit nebo změnit agenta sestavení.

  2. Vyberte agenta sestavení, kterého chcete odebrat, a klikněte na tlačítko Odebrat.

Tip

Konzolu pro správu Team Foundation můžete také použít k odebrání agenta sestavení v době, kdy jste přihlášeni k serveru sestavení.

Další kroky