Diagnostika problémů v sestavení

Diagnostika a řešení potíží se sestavením jsou běžné úlohy při vývoji softwaru.Team Foundation Build obsahuje nástroje, které vám pomohou při ladění a řešení problémů, jako například:

• Sestavení se nezdařilo nebo je částečně úspěšné

• Výjimky, chyby a varování

• Neočekávané události nebo výsledky

Co chcete udělat?

• Určení, proč sestavení není spuštěno

• Vyhledání informací o problému v okně výsledků sestavení

• Žádost o diagnostické protokoly a jejich zobrazení

• Ověření systému sestavení a provedení ladění procesu sestavení

• Získat další tipy

Požadovaná oprávnění

Musíte být členem skupiny Správci systému Windows na serveru sestavení a členem skupiny Správci sestavení kolekcí projektů v kolekci týmových projektů.Další informace naleznete v tématu Oprávnění v prostředí Team Foundation Server.

Určení, proč sestavení není spuštěno

Pokud je sestavení další ve frontě, ale stále není spuštěno, přesvědčte se, zda je kontrolér sestavení a alespoň jeden z jeho sestavovacích agentů k dispozici a povolen.Pokud má váš proces sestavení filtry sestavovacích agentů, ujistěte se, že sestavovací agent, který splňuje kritéria, je k dispozici a povolen.Viz téma Správa systému sestavení, Určení sestavovacích agentů, které zpracují sestavení a Nasazení a konfigurace agentů sestavení.

Vyhledání informací o problému v okně výsledků sestavení

Pokud je vaše sestavení v provozu, zaseknuto v některé části procesu nebo dokončeno, můžete získat další informace o problémech v okně výsledků sestavení.Podrobnější informace získáte po zvolení možnosti Zobrazit protokol:

• Chcete-li přeskočit přímo k problémům v sestavení, zvolte možnost Následující chyba nebo Následující varování.

• Po zobrazení instancí odkazu souboru protokolu MSBuild tento odkaz vyberte, čímž získáte podrobnější informace o událostech, které nastaly při sestavení vašeho kódu a provedení ostatních úloh aktivitou MSBuild.

• Můžete kopírovat informace a v případě potřeby je sdílet s uživateli, kteří vám mohou pomoci vyřešit problémy.Vyberte konkrétní pasáže v záznamu nebo otevřete kontextovou nabídku z libovolného místa v protokolu a potom zvolte možnost Vybrat vše.Potom můžete zkopírovat text do schránky otevřením kontextové nabídku a zvolením možnosti Kopírovat.

Zobrazení diagnostických protokolů

Pokud stále nemáte dostatek informací k diagnostice problému, můžete zobrazit podrobnější diagnostické protokoly.V okně výsledků sestavení zvolte možnost Diagnostika a pak:

• Po dokončení sestavení zvolte možnost Konečné protokoly od date and time.

• Pokud sestavení ještě není dokončeno, zvolte možnost Vyžádat protokoly.

  

  Systém sestaví protokoly.

  Když jsou protokoly připravené, zvolte možnost Diagnostika, V době date and time pro User who requested the log.

Pokud vaše fáze sestavení umísťují výstup dat do odkládací složky na cestě UNC, systém otevře podsložku odkládací složky, která obsahuje diagnostické protokoly.Po otevření odkládací složky nebo stažení souboru .zip můžete zobrazit jeden z následujících protokolů:

• Z kontroléru sestavení: ActivityLog

• Z každého sestavovacího agenta, který se účastnil sestavení: **ActivityLog.AgentScope.**Build_Agent_ID

• Pro každé řešení sestavené v rámci aktivity MSBuild: Solution_Name

Nejlepší způsob, jak zobrazit tyto protokoly, je zkopírovat je do počítače pro vývoj a otevírat je z něj.

[!POZNÁMKA]

Pokud používáte sadu Visual Studio 2010, nabídka Diagnostika není zobrazena v okně výsledků sestavení, ale můžete zobrazit diagnostické protokoly v odkládací složce po dokončení sestavení.

Ověření systému sestavení a provedení ladění procesu sestavení

Některé problémy mohou být způsobeny místním sestavením systému.

Tip

Pokuste se nasadit vývojářský počítač jako server sestavení tak, abyste mohli snadno získat přímý přístup k prostředí, ve kterém je spuštěn proces sestavení.Další informace naleznete v tématu Nasazení a konfigurace serveru pro sestavení.

Kontrola součástí systému sestavení

Přesvědčte se, že je správně nakonfigurován váš server, kontrolér a sestavovací agent.Informace naleznete v tématech Nasazení a konfigurace serveru pro sestavení, Nasazení a konfigurace kontroleru sestavení a Nasazení a konfigurace agentů sestavení.

Přihlaste se k serveru sestavení a ověřte, zda pracuje správně.Můžete také zobrazit podrobné diagnostické údaje na serveru sestavení.Další informace naleznete v tématu Správa systému sestavení.

Ladění procesu sestavení na serveru sestavení

Chcete-li diagnostikovat potíže způsobené aktivitami vlastního procesu sestavení nebo nezachycenými výjimkami, zkuste ladit proces sestavení na svém serveru sestavení.

1. Přihlaste se k serveru sestavení.

2. Spusťte sadu Visual Studio jako správce.

3. V sadě Visual Studio v panelu nabídek zvolte položky Nástroje, Připojit k procesu.

4. V dialogovém okně Připojit k procesu:

   1. Vyberte možnost Zobrazit procesy všech uživatelů.

   2. Vyberte TFSBuildServiceHost.exe.

   3. Zvolte možnost Připojit.

5. Na panelu nabídek vyberte možnost Ladit > Výjimky.V dialogovém okně Výjimky vyberte možnost Výjimky modulu CLR.Klikněte na tlačítko OK.

6. V panelu nabídek zvolte možnost Nástroje, Možnosti.V dialogovém okně Možnosti v podokně stromu vyberte možnost Ladění.V seznamu Obecné zrušte zaškrtnutí políčka Povolit volbu Pouze vlastní kód.Klikněte na tlačítko OK.

7. V sadě Visual Studio vložte sestavení do fronty a ujistěte se, že běží na kontroléru sestavení a serveru sestavení, jejichž hostitelem je server sestavení, na kterém jste povolili ladicí program.

Nyní můžete ladit výjimky, které jsou vyvolány během procesu sestavení, a také nastavit zarážky a ladit své vlastní aktivity procesu sestavení.Další informace naleznete v tématu Ladění v sadě Visual Studio.

Tipy

• Když diagnostikujete problémy s procesem sestavení, můžete uložit sami sebe a problémy členů svého týmu, dokud nebudete moci proces opravit:

  • Upravte definici sestavení a potom v dolní části karty Obecné vyberte možnost Pozastaveno.

  • Pokud chcete otestovat opravy procesu sestavení, zaškrtněte políčko sestavení ve frontě, otevřete jeho kontextovou nabídku a zvolte možnost Spustit.

• Pokud se domníváte, že některé součásti systému sestavení mohou být příčinou některého z problémů, můžete spustit, zastavit či restartovat server sestavení nebo povolit či zakázat kontrolér nebo agenta podle potřeby.Další informace naleznete v tématu Správa systému sestavení.

• Při pokusu o odstranění potíží s procesem sestavení je často nutné opakovaně k testování různých oprav vložit do fronty sestavení se stejnými možnostmi.Sestavení můžete rychle znovu vyzkoušet:

  • V okně s výsledky sestavení zvolte možnost Akce > Znovu sestavit.

  • Ze stránky Sestavení v aplikaci Team Explorer nebo z Průzkumníku sestavení vyberte dokončené sestavení, otevřete kontextovou nabídku a zvolte možnost Znovu sestavit.

• Používáte kontrolér hostovaného sestavení?Viz Použití kontroléru hostovaného sestavení.