Diagnostika problémů sestavení

Diagnostika a řešení problémů se sestavení je běžný úkol při vývoji softwaru.Team Foundation Build poskytuje nástroje, které vám pomohou diagnostikovat a vyřešit problémy, jako je například:

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

• Výjimky, chyby nebo varování

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

Co chcete udělat?

• Zjistěte, proč není spuštěna sestavení

• Vyhledejte informace o problému v okně výsledky sestavení

• Řešení problémů při použití řadiče hostované sestavení

• Žádost a zobrazit diagnostické protokoly

  • Získat diagnostické protokoly, pokud používáte řadič sestavení služby v prostorách

  • Získat diagnostické protokoly, pokud používáte řadič hostované sestavení

  • Zobrazit diagnostické protokoly

• Systém sestavení a ladění procesu sestavení

• Získejte další tipy

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.

Zjistěte, proč není spuštěna sestavení

Pokud sestavení není další ve frontě , ale je stále není spuštěna, přesvědčte se, zda řadič sestavení a alespoň jeden z jeho agentů sestavení jsou k dispozici a povoleno.Pokud váš proces sestavení sestavení agent filtry, ujistěte se, agenta sestavení, který splňuje kritéria je k dispozici a povoleno.Viz Manage Your Build System, určit, který proces agenti sestavení vašeho sestavení, a Nasazení a konfigurace agentů sestavení.

Vyhledejte informace o problému v okně výsledky sestavení

Pokud vaše sestavení běží v některé části procesu nebo dokončit, pak můžete získat další informace o problémech v vytvořit okno výsledky.Zvolte Zobrazit protokol Chcete-li zobrazit podrobnější informace:

• Zvolte Další chyba nebo Další varování Chcete-li přejít přímo na problémy v sestavení.

• Kdykoli zobrazit instance Soubor protokolu nástroje MSBuild propojení, vyberte jej, chcete-li získat podrobnější informace o událostech, ke kterým došlo při MSBuild aktivity zkompilovaný kód a provádět další úkoly.

• Můžete zkopírovat informace a v případě potřeby jej 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ření místní nabídky z libovolného místa v protokolu a potom zvolte Vybrat vše.Pak otevřete místní nabídku a zvolte kopie Chcete-li zkopírovat text do schránky.

Zobrazit diagnostické protokoly

Pokud stále nemáte dostatek informací určit příčinu potíží, můžete zobrazit podrobnější diagnostické protokoly.

Získat diagnostické protokoly, pokud používáte řadič sestavení služby v prostorách

Při provozování řadiče sestavení v prostorách diagnostické protokoly jsou uloženy v ukládací složka.V vytvořit okno výsledky, zvolte Diagnostikaa pak:

• Pokud je sestavení, zvolte konečné protokoly jako datum a čas,.

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

  

  Systém sestaví protokoly.

  V případě, že protokoly jsou připraveny, zvolte Diagnostika, k datum a čas pro uživatele, který požaduje protokol.

Systém otevře podsložku složky přetažení, obsahující diagnostické protokoly.

[!POZNÁMKA]

Používáte-li aplikaci Visual Studio 2010 Diagnostika nabídce se nezobrazí v okně výsledky sestavení, ale můžete zobrazit diagnostické protokoly v ukládací složku po dokončení sestavení.

Získat diagnostické protokoly, pokud používáte řadič hostované sestavení

Při použití Hostované sestavení řadič, doporučujeme, abyste vybrali kopie sestavení výstup na server pro pracovní místo.V tomto případě diagnostické protokoly jsou uloženy v TFS a lze je zobrazit a stáhnout z webového prohlížeče.

V vytvořit okno výsledky, zvolte Akce, Otevřít v prohlížečia pak ve výsledcích sestavení ve webovém prohlížeči zvolte Diagnostika.Potom můžete použít Zobrazit protokoly otevřete nabídku, ze které můžete použít protokol, který chcete zobrazit nebo stáhnout všechny protokoly v souboru ZIP.

Zobrazit diagnostické protokoly

Po otevření složky pro ukládání nebo stahování souboru ZIP můžete zobrazit jeden z následujících protokolů:

• Z řadiče sestavení:ActivityLog

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

• Pro každý roztok sestavil MSBuild aktivity: Solution_Name

Nejlepší způsob, jak zobrazit tyto protokoly je zkopírovat do počítače dev a otevírat je z tohoto místa.

Systém sestavení a ladění procesu sestavení

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

Tip

Zkuste nasazení počítače dev jako sestavení serveru tak, aby bylo možné snadněji získat přímý přístup k prostředí, ve kterém je spuštěn proces sestavení.Viz téma Nasazení a konfigurace serveru pro sestavení.

Zkontrolujte systémové součásti sestavení

Ujistěte se, zda jsou správně konfigurovány sestavení server, řadič a agent.See Nasazení a konfigurace serveru pro sestavení, Nasazení a konfigurace kontroleru sestavení, and 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 sestavení serveru.Viz téma Manage Your Build System.

Ladění procesu sestavení na server sestavení

Chcete-li diagnostikovat potíže způsobené vlastní sestavení proces činnosti, nebo pomocí nezachycené výjimek, ladění procesu sestavení na sestavení serveru.

1. Přihlaste se k serveru sestavení.

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

3. V aplikaci Visual Studio, z nabídky panelu zvolte Nástroje, připojit k procesu.

4. V připojit k procesu dialogové okno:

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

   2. Vyberte TFSBuildServiceHost.exe.

   3. Zvolte Připojit.

5. Z nabídky panelu zvolte ladění, výjimky.V výjimky dialogové okno, vyberte Výjimky modulu CLR.Klepněte na tlačítko OK.

6. Z nabídky panelu zvolte Nástroje, Možnosti.Na Možnosti dialogové okno, v podokně stromu vyberte ladění.V Obecné seznam a zrušte Povolit pouze můj kód políčko.Klepněte na tlačítko OK.

7. V aplikaci Visual Studio fronty sestavení a ujistěte se, že běží na řadič sestavení a sestavení serveru, které jsou hostovány na serveru sestavení, ve 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é aktivity procesu vlastní sestavení.Viz téma Ladění aplikace Visual Studio.

Tipy

• V době, kdy jsou Diagnostika problémů pomocí procesu sestavení, je možné ušetřit vás a vaše problémy s ostatními členy týmu ponecháte jej dokud neopravíte procesu:

  • Úprava definice sestavenía poté v dolní části Obecné , vyberte pozastaveno.

  • Zatímco definice sestavení je pozastaveno, testování vaší opravy procesu sestavení vyberte ve frontě sestavení, otevřete místní nabídku a zvolte Spustit.

• Pokud si myslíte, že některé systémové součásti sestavení může být příčinou jeden z problémů, můžete spustit, zastavit, nebo restartujte server sestavení nebo povolit nebo zakázat řadič nebo agenta podle potřeby.Viz téma Manage Your Build System.

• Často při pokusu o vyřešení potíží proces sestavení je nutné sestavení se stejnými možnostmi opakovaně, chcete-li vyzkoušet různé opravy ve frontě.Můžete rychle zopakovat sestavení:

  • Z vytvořit okno výsledky volbou Akce, Znovu sestavit.

  • Z vytvoří stránku v Průzkumník týmových projektů nebo z Průzkumníka sestavit výběrem dokončení sestavení otevřením jeho místní nabídka a volba Znovu sestavit.