Sdílet prostřednictvím


Nasazení a konfigurace agentů sestavení

Chcete-li použít Team Foundation Build, váš tým musí mít alespoň jeden agent sestavení provádět náročné práce procesu sestavení.

Sestavení dvou serverů

Každému agentovi sestavení je vyhrazen pro a řízena řadič jednoho sestavení.Agenti sestavení mohou být hostovány na stejném serveru sestavení, který je hostitelem jejich řadič sestavení, ale tento krok není povinný a v některých případech potřebách vašeho týmu lze co nejefektivněji vyhovět serveru jediné sestavení do hostitelského řadiče sestavení, která řídí agentů sestavení na více serverech sestavení.

Agenta sestavení provede kroky procesu sestavení, která jsou obsažena v AgentScope činnosti.Obvykle tyto kroky zahrnují načítání souborů z verzí zřizování prostoru kompilování kódu spuštění testů a sloučení souborů zpět do správy verzí.

Přesvědčte se, zda sestavení serveru, který hostí vaši agenti sestavení má dostatečné schopnosti skladování a zpracování tak, aby odpovídal velikosti a složitosti codebase a zkoušek kolekce týmového projektu.Obvykle by hostit více než jednoho agenta sestavení za jádro procesoru na serveru sestavení.Můžete také zvýšit výkon tím, že přidělíte jeden fyzický pevný disk k pracovní adresář z každého agenta sestavení.

Tip

Pokud vaše kolekce týmového projektu je umístěn na Službu Team Foundationa potřebách vašeho týmu může být uspokojen agenta sestavení jediný standardní, můžete použít Hostované sestavení řadič 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 Team Foundation Oprávnění serveru.

Co chcete udělat?

Vytvořit nebo upravit agenta sestavení

Chcete-li vytvořit nebo upravit agenta sestavení ze serveru sestavení

  1. Přihlásit Sestavit server , kterou chcete konfigurovat.

  2. Z nabídky Start systému Windows spustit Konzola pro správu serveru Team Foundation.

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

  3. V podokně stromu Team Foundation Administration Console rozbalte název serveru a pak zvolte Sestavení konfigurace uzlu.

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

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

  4. Na stránce konfigurace sestavení:

    • Chcete-li vytvořit nového agenta sestavení, zvolte Nový Agent.

    • Chcete-li upravit existující agenta sestavení

      Vytvoření zástupce

      Zvolte Vlastnosti.

    Zobrazí se dialogové okno Vlastnosti agenta sestavení.

Chcete-li změnit agenta sestavení ze sady Visual Studio

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

    1. Pokud ještě nejste připojeni k týmovému projektu v kolekce týmového projektu, pak připojení k týmovému projektu.

    2. Vyberte Ikona Domovská stránkaDomů, a pak vyberte Vytvoří ikonuSestavení.

  2. Na stránce sestavení zvolte Akcea potom Správa řadičů sestavení.

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

    Dialogové okno Spravovat řadiče sestavení

  3. Vybrat agenta sestavení, které chcete upravit a pak zvolte Vlastnosti.

    Zobrazí se dialogové okno Vlastnosti agenta sestavení.

Vytvořit dialogové okno Vlastnosti zástupce

Zobrazovaný název, Popis: Zadejte název a popis, který má pomoci členům týmu snadno identifikovat agenta sestavení.

Řadič: vyberte sestavit řadič chtějí ovládat Tento agent sestavení.Řadič sestavení lze spustit na stejném serveru sestavení jako Tento agent sestavení nebo na jiné sestavení serveru.

Naleznete v části Další informace o konfiguraci vašeho agenta sestavení.

Instalace aplikace Visual Studio a další software, chcete-li povolit kompilace a další možnosti

Je doporučeno nainstalovat verzi sady Visual Studio, který váš tým používá ve svých počítačích dev agenta sestavení.Viz téma Instalace sady Visual Studio.Také byste měli instalovat další software a součásti, které jsou nainstalovány v počítačích vaší dev a které jsou nutné k vytvoření aplikace.Jinak mohou mít problémy, jako jsou například některé z vašich projektů kód selhání kompilace.

Zadat pracovní adresář

Můžete určit pracovní adresář agenta sestavení se 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žky v této složce.

Tip

Můžete zvýšit výkon tím, že přidělíte jeden fyzický pevný disk k pracovní adresář z každého agenta sestavení.

Bb399135.collapse_all(cs-cz,VS.110).gifPoužít pracovní adresář tokeny

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

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

    Tip

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

  • Team Foundation Build proměnné
    Můžete používat následující proměnné v sestavení agent práce adresář:

    • $(BuildAgentId): Celé automaticky generované číslo, které jednoznačně identifikuje agenta sestavení do kolekce týmového projektu.

    • $(BuildAgentName): Na Zobrazované jméno agenta sestavení.

    • $(BuildDefinitionId): Celé automaticky generované číslo, které jednoznačně identifikuje definici sestavení do kolekce týmového projektu.

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

Bb399135.collapse_all(cs-cz,VS.110).gifPříklad pracovní adresář

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

C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild

C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild

Bb399135.collapse_all(cs-cz,VS.110).gifUjistěte se, že cesta do pracovního adresáře je příliš dlouhý.

Pracovní adresář, který určíte nesmí způsobit agenta sestavení k výrobě fyzické cesty, které jsou delší než 259 znaků.Jinak, vaše sestavení může selhat a protokolu k této chybě: TF10128: The pathFyzická_cesta 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 zadat například $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), což by mělo za následek pracovní adresář, jako je například: c:\bld\3\2\.

Bb399135.collapse_all(cs-cz,VS.110).gifVytvořeno v pracovním adresáři podadresáře

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

Podadresář

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

Sources

Přečteno agenta sestavení, jako je například zdrojové soubory.Určete soubory, soubory ke stažení v prostoru nastavení pro každý sestavení definice.Viz téma Práce s sestavení pracovních prostorů.

Binaries

Kompilovány pomocí agenta sestavení, jako jsou například soubory zkompilované aplikace.

TestResults

Získaný jakékoli zkoušky byl spuštěn agent sestavení.

Povolit agenta sestavení, chcete-li spustit testy

Můžete definovat nové sestavení proces, který provádí jeden nebo více automatizované zkušební jízdy.

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

Různé druhy zkoušek a test operace vyžadují instalaci na váš agenta sestavení stejnou verzi aplikace Visual Studio, který váš tým používá ve svých počítačích dev.Viz téma Instalace sady Visual Studio.

Můžete spustit agenta sestavení:

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

S narůstajícím měřítko sestavení systému, budete muset definovat agentů specializované sestavení.Při každém agenta sestavení obsahuje zvláštní funkce nebo je určena pro konkrétní druh využití, byste měli přiřadit jednu nebo více visaček tohoto agenta.Tímto způsobem, když člen týmu vytvoří definici sestavení, který vyžaduje určitý druh agenta sestavení, mohou značky zadat v jejich definice sestavení.

Můžete přiřadit tagy z dialogové okno Vlastnosti agenta sestavení, je popsáno výše.Potom můžete použití značek pro vaše sestavení definice.

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

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

K identifikaci sestavení agenta, který může...

x86

Kompilace 32bitové aplikace

x64

Kompilovat 64bitových aplikací

BVT

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

WindowsStore

Sestavit a otestovat app úložiště systému Windows.

IIS

Zkompilujte webovou aplikaci technologie ASP.NET a pak fáze a hostitelské počítače, ve kterém je spuštěn agent sestavení.

interaktivní

Provedení úlohy vyžadující agenta sestavení serveru, který běží v interaktivní režim.

Použijete-li více než jednu značku agenta sestavení.Můžete například vytvořit agenta sestavení značky x 86 a uvolnění označíte agenta, který je nastaven pro konfiguraci uvolnění 32bitová aplikace zkompilovat.

Je-li spustit více agentů sestavení na stejné sestavení serveru, pravděpodobně budou všechny mají stejné možnosti.Proto pravděpodobně chcete použít stejné značky všech agentů sestavení na sestavení serveru.

Odebrání agenta sestavení

  1. V aplikaci Visual Studio otevřete Správa řadičů sestavení dialogové okno, jak je popsáno dříve v Vytvořit nebo upravit agenta sestavení.

  2. Vybrat agenta sestavení, který chcete odebrat a pak zvolte Odebrat.

Tip

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

Další kroky