Spravovat informace o sestavení a podrobnost řízení
Chcete-li získat podrobné informace o dokončení sestavení:
Jak sestavení proběhlo? Bylo sestavení úspěšné?Kdy bylo spuštěno?Jak dlouho sestavení trvalo?Jaký byl výkon tohoto sestavení ve srovnání s předchozími sestaveními?
Co bylo sestaveno? Která řešení, sady změn a opravy chyb byly vstupem pro toto sestavení?
Co se nepodařilo? K jakým upozorněním nebo chybám došlo?Které testy se nezdařily?
Míru podrobností informací uložených o každém dokončeném sestavení lze systematicky řídit při definování procesu sestavení.Alternativně lze tuto míru řídit pro jednotlivé spuštění sestavení ve chvíli, kdy je sestavení zařazováno do fronty.
V tomto tématu
Jak jsou generovány informace o sestavení a jak plynou
Definice procesu sestavení
Zařazení procesu sestavení do fronty a jeho spuštění
Vytvoření, filtrování a uložení informací o sestavení
Načtení informací o sestavení
Nastavení parametru procesu sestavení pro míru podrobností protokolování
Osvědčený postup: nastavte míru podrobností na nejnižší možnou úroveň
Použijte při spuštění sestavení nejmenší míru podrobností
Použijte nejmenší míru podrobností při návrhu šablony vlastního procesu sestavení
Další informace
Jak jsou generovány informace o sestavení a jak plynou
.png "Tok informací a podrobností nastavení sestavení")
.gif "Hh190720.collapse_all(cs-cz,VS.110).gif")
Definice procesu sestavení
.gif "Krok 1")
Míru podrobností informací lze systematicky řídit při vývoji procesu sestavení.Při vytváření nebo upravování definice sestavení založené na Výchozí šabloně nebo Inovační šabloně zobrazte kartu Proces.V uzlu Základní lze vybrat hodnotu v seznamu Podrobnost protokolování a zadat tak parametr tohoto procesu sestavení.
V případech, kdy předdefinované šablony nevyhovují potřebám, lze vyvinout vlastní šablonu procesu sestavení.Při vytváření tohoto typu šablony by měly být opatrně zapsány informace o sestavení.Další informace naleznete v tématu Použití minimální míry podrobností při návrhu vlastní šablony procesu sestavení.
Zařazení procesu sestavení do fronty a jeho spuštění
.gif "Krok 2")
Nastavení Podrobnosti protokolování lze ručně přepsat při zařazení sestavení založeného na Výchozí šabloně nebo Inovační šabloně do fronty.V dialogovém okně Zařazení sestavení do fronty zvolte kartu Parametry, rozbalte uzel Základní a určete parametr tohoto procesu sestavení zvolením hodnoty ze seznamu Podrobnost protokolování.Tato hodnota je použita pro jediné spuštění sestavení.
Vytvoření, filtrování a uložení informací o sestavení
.gif "Krok 3")
Sestavovací systém předává hodnotu parametru procesu sestavení Verbosity do Verbosity.Tato vlastnost se používá k filtrování informací sestavení, která je zaznamenána a uložena na serveru Team Foundation Server pomocí Information z následujících zdrojů:
Pracovní činnosti: několik pracovních činností generují zprávu, je-li operace úspěšně dokončena, nebo varování či chybu, dojde-li v operaci k chybě.Například aktivita SyncWorkspace generuje zprávy s nízkou důležitostí při stahování zdrojového kódu a jiných souborů ze serveru do agenta sestavení.Tato aktivita generuje chyby, pokud se stahování souborů nezdaří.Jiným příkladem je aktivita OpenWorkItem generující varování, pokud se jí nepodaří vytvořit pracovní položku.
Lze použít další pracovní aktivity pro přímé psaní vlastních informací o sestavení.Další informace naleznete v tématu Návrh šablony vlastního procesu sestavení, který zapisuje informace s nejmenší nutnou mírou podrobností.
Kompilace kódu: proces sestavení používá aktivitu MSBuild pro využití systému MSBuild ke kompilování binárních souborů a provádění jiných důležitých úkolů.Vlastnost Verbosity této aktivity řídí míru podrobností informací, které tento proces generuje a publikuje do následujících umístění:
Sady Team Foundation Server ukládá výsledky kompilace, chyby a upozornění.
Protokol do ukládací složky ukládá stejné informace jako sady Team Foundation Server spolu s všechny ostatní zprávy, které MSBuild vytváří.
Testovací kód: proces sestavení používá aktivitu RunTests nebo MSTest pro provádění testů.Všechny zprávy, které tyto činnosti protokolu se zařazují s hodnotou důležitosti vysoké, je-li řadič sestavení v prostorách nebo nízké používáte Hostované sestavení řadič...
Načtení informací o sestavení
.gif "Krok 4")
Souhrnné i detailní informace lze získat při průběhu sestavení i po jeho dokončení z okna výsledků sestavení.Tyto informace lze z okna zkopírovat do schránky.Lze se také přímo propojit s ukládací složkou a načíst protokoly, binární soubory a jiná data.
Parametr procesu sestavení Podrobnost protokolování
V procesu sestavení založeném na Výchozí šabloně nebo Inovační šabloně lze použít parametr procesu sestavení Podrobnost protokolování pro správu míry podrobností zaznamenaných a uložených informací.
Následující tabulka vypisuje hodnoty parametru Podrobnost protokolování a jejich odpovídající účinky:
Value |
Chyby |
Upozornění |
Zprávy sestavení s vysokou důležitostí |
Zprávy s normální důležitostí |
Zprávy s nízkou důležitostí |
Vlastnosti pracovní činnosti (vstupy a výstupy) |
|---|---|---|---|---|---|---|
Minimální |
Y |
N |
N |
N |
N |
N |
Normálně |
Y |
Y |
Y |
N |
N |
N |
Podrobný |
Y |
Y |
Y |
Y |
N |
N |
Diagnostické (Tip:: ve většině případů můžete použít diagnostické protokoly.See Diagnostika problémů sestavení.) |
Y |
Y |
Y |
Y |
V prostorách sestavit řadič: Y |
Y |
Osvědčený postup: nastavte míru podrobností na nejnižší možnou úroveň
Ačkoli jsou informace o sestavení důležité, proces sestavení zaznamenávající příliš mnoho informací může způsobit problémy.Tyto problémy patří spotřebovávání příliš velký úložný prostor na serveru Team Foundation Server, snížit výkon aplikace Visual Studio a přetížení členům týmu se více informací, než může zpracovávat.
Použijte při spuštění sestavení nejmenší míru podrobností
Při spuštění sestavení by obecně měl být dodržen postup použití nejnižšího nastavení míry podrobností, které stále poskytuje informace potřebné k dosažení cíle.
Použijte nejmenší míru podrobností při návrhu šablony vlastního procesu sestavení
Uživatelé procesu sestavení se spoléhají na filtrování míry podrobností pro omezení přetížení informacemi.Efektivitě tohoto filtrování lze dopomoci následujícími opatřeními:
Ujistěte se, že volíte nejvhodnější aktivitu, která zapíše zprávu: Aktivita WriteBuildMessage, Aktivita WriteBuildWarning, Aktivita WriteBuildError nebo WriteBuildTestError.
Při použití aktivity Aktivita WriteBuildMessage pro záznam informací přistupujte k nastavování vlastnosti Importance záměrně a konzistentně.Použijete-li pro zprávu vyšší hodnotu důležitosti, je zapotřebí mít na paměti, že tím může dojít ke zvýšení množství uložených a týmovým členům prezentovaných dat.
[!POZNÁMKA]
Dopad takového rozhodnutí může být obzvláště výrazný při použití těchto aktivit uvnitř konstrukce smyčky jako například DoWhile, ForEach<T> nebo While.
Další informace
Diagnostika problémů sestaveníPopisuje, jak získat diagnostické protokoly.
Team Foundation Vytvoření aktivit popisuje pracovní činnosti procesu sestavení, o kterých se zmiňuje toto téma.
Definovat proces vytváření, který je založen na výchozí šabloně a Použití starší verze sestavení procesy poskytují rady o tom, jak vytvořit a udržovat definice sestavení založené na Výchozí šabloně a Inovační šabloně
Zobrazení výsledků sestavení poskytuje návod, jak používat okno výsledků sestavení.
IBuildDetail, BuildMessageImportance a BuildVerbosity popisují některé klíčové prvky rozhraní Team Foundation Build API, které poskytují funkcionalitu pro informace sestavení.
Referenční dokumentace pro použití nástroje MSBuild v příkazovém řádku popisuje systém MSBuild.
Zadejte aktivační události sestavení a důvody a Fronty sestavení popisují, jak automaticky a ručně zařadit sestavení do fronty.