Diagnostiquer des problèmes de build

Article
03/04/2013

Le diagnostic et résoudre les problèmes de génération est une tâche normale dans le développement de logiciel.Team Foundation Build fournit des outils pour vous aider à diagnostiquer et à résoudre des problèmes tels que :

Builds ou partiellement réussies
Exceptions, erreurs, ou avertissements
Événements ou résultats inattendus

Que voulez-vous faire ?

Déterminez pourquoi une génération ne s'exécute pas
Recherchez des informations sur un problème dans la fenêtre résultats de la génération
Résolvez les problèmes à l'aide de le contrôleur de build hébergé
Demandez et afficher des journaux de diagnostic
- Obtenir des journaux de diagnostic lorsque vous utilisez un contrôleur de build de dessus principe
- Obtenir des journaux de diagnostic lorsque vous utilisez le contrôleur de build hébergé
- Affichez les journaux de diagnostic
Vérifiez votre système de génération et de débogage votre processus de génération
Obtenir plus de conseils

Autorisations requises

Vous devez être membre du groupe Administrateurs de windows sur le serveur de builds, et membre du groupe Administrateurs de génération de collection de projets sur votre collection de projets d'équipe.Consultez Autorisations de Team Foundation Server.

Déterminez pourquoi une génération ne s'exécute pas

Si la génération est la suivante dans la file d'attente mais ne s'exécute pas, assurez-vous que le contrôleur de build et au moins celui de ses agents de build sont disponibles et activés.Si votre processus de génération a des filtres d'agent de build, vérifiez qu'un agent de build qui répond aux critères est disponible et activé.Voir Manage Your Build System, Spécifier les agents de build qui traitent votre build, et le Déployer et configurer des agents de build.

Recherchez des informations sur un problème dans la fenêtre résultats de la génération

Si votre build s'exécute, collé à une partie du processus, ou terminé, vous pouvez obtenir plus d'informations sur les problèmes dans fenêtre résultats de la génération.Choisissez Afficher le journal pour afficher davantage d'informations détaillées :

Choisissez Erreur suivante ou Avertissement suivant accéder directement aux problèmes dans la build.
Partout où vous consultez les instances Fichier journal MSBuild le lient, choisissez pour obtenir davantage d'informations détaillées concernant les événements qui se sont produits lorsque l'activité de MSBuild a compilé votre code et a effectué d'autres tâches.
Vous pouvez copier les informations et, si vous le souhaitez, les partager avec des personnes qui peuvent vous aider à résoudre les problèmes.Sélectionnez les séries spécifiques dans le journal ou ouvrez un menu contextuel n'importe quel endroit du journal et choisissez Sélectionner tout.Vous pouvez ensuite ouvrir un menu contextuel et choisir Copier pour copier le texte dans le presse-papiers.

Journaux de diagnostic de vue

Si vous n'avez pas encore assez d'informations pour diagnostiquer un problème, vous pouvez afficher des journaux de diagnostic plus détaillés.

Obtenir des journaux de diagnostic lorsque vous utilisez un contrôleur de build de dessus principe

Lorsque vous hébergez un contrôleur de build de dessus principe, les journaux de diagnostic sont stockés dans dossier de dépôt.Dans fenêtre résultats de la génération, choisissez Diagnostics, puis :

Si la génération est terminée, choisissez Journaux finaux as of de date et heure.
Si la génération n'est pas encore terminée, choisissez Demander les journaux.

Le système assemble les journaux.

Lorsque les journaux sont prêts, choisissez Diagnostics, As of de date et heure pour L'utilisateur qui a demandé le journal.

Le système ouvre un Sub- dossier du dossier de dépôt qui contient les journaux de diagnostic.

[!REMARQUE]

Si vous utilisez Visual Studio 2010, le menu Diagnostics n'est pas affiché dans la fenêtre résultats de la génération, mais vous pouvez toujours afficher les journaux de diagnostic le dossier de dépôt lorsque la génération est terminée.

Obtenir des journaux de diagnostic lorsque vous utilisez le contrôleur de build hébergé

Lorsque vous utilisez Contrôleur de build hébergé, nous recommandons que vous sélectionnez Copier sur le serveur la sortie de la génération pour emplacement temporaire.Dans ce cas, les journaux de diagnostic sont stockés dans TFS et vous pouvez les consulter et les télécharger à partir de votre navigateur Web.

Dans fenêtre résultats de la génération, choisissez Actions, Ouvrir dans un navigateur, puis dans les résultats de build dans le navigateur Web, choisissez diagnostics.Vous pouvez ensuite sélectionner Afficher les journaux pour ouvrir un menu à partir duquel vous pouvez choisir le journal que vous souhaitez afficher, ou pour télécharger tous les journaux un fichier .zip.

Affichez les journaux de diagnostic

Après avoir ouvert le dossier de dépôt ou avez téléchargé le fichier .zip, vous pouvez afficher un des journaux suivants :

Le contrôleur de build : ActivityLog
De chaque agent de build qui a participé à la génération : **ActivityLog.AgentScope.**Build_Agent_ID
Pour chaque solution compilée par l'activité de MSBuild : Solution_Name

Le meilleur moyen d'afficher ces journaux est de les copier à votre ordinateur de développement (dev) et de les ouvrir à partir de celui-ci.

Vérifiez votre système de génération et de débogage votre processus de génération

Certains problèmes peuvent être provoqués par votre système de génération de dessus principe.

Conseil
Test du déploiement de votre ordinateur de développement (dev) en tant que serveur de builds pour pouvoir facilement obtenir l'accès direct à l'environnement dans lequel le processus de génération exécute.Consultez Déployer et configurer un serveur de build.

Vérifiez vos composants système de génération

Assurez-vous que votre serveur de builds, contrôleur, et agent sont correctement configurés.Consultez Déployer et configurer un serveur de build, Déployer et configurer un contrôleur de build et Déployer et configurer des agents de build.

Connectez-vous au serveur de builds et vérifiez qu'il fonctionne correctement.Vous pouvez également consulter les données de diagnostic détaillées sur le serveur de builds.Consultez Manage Your Build System.

Le débogage d'un processus de génération sur le serveur de builds

Pour diagnostiquer des problèmes provoqués par des activités de processus de génération personnalisé, ou par les exceptions non interceptées, essayez de déboguer le processus de génération sur votre serveur de builds.

Connectez-vous au serveur de build.
Exécutez Visual Studio en tant qu'administrateur.
Dans Visual Studio, de la barre de menus, sélectionnez Outils, Attacher au processus.
Dans la boîte de dialogue Attacher au processus :
1. Sélectionnez Afficher les processus de tous les utilisateurs.
2. Sélectionnez TFSBuildServiceHost.exe.
3. Choisissez Attacher.
Dans la barre de menus choisissez Déboguer, Exceptions.Dans la boîte de dialogue Exceptions, sélectionnez Exceptions du common langage runtime.Cliquez sur OK.
Dans la barre de menus, sélectionnez Outils, Options.Dans la boîte de dialogue Options, dans le volet d'arborescence, sélectionnez Débogage.Dans la liste Général, et désactivez la case à cocher Activer Uniquement mon code .Cliquez sur OK.
Dans Visual Studio, mettez en file d'attente la build et vérifiez qu'il s'exécute sur un contrôleur de build et un serveur de builds qui sont hébergés sur le serveur de builds sur lequel vous avez activé le débogueur.

Vous pouvez à présent déboguer les exceptions levées pendant le processus de génération, et également définir des points d'arrêt et déboguer vos activités de processus de génération personnalisé.Consultez Débogage dans Visual Studio.

Conseils

Pendant que vous diagnostiquez des problèmes avec un processus de génération, vous pouvez en enregistrer et vos coéquipiers problèmes d'en suspendant jusqu'à ce que vous puissiez réparer le processus :
- Modifiez la définition de build, puis en bas de l'onglet de Général, choisissez Suspendu.
- Alors que la définition de build est suspendue, pour tester vos corrections au processus de génération, sélectionnez génération en file d'attente, ouvrez le menu contextuel, puis choisissez Démarrer maintenant.
Si vous considérez un de vos composants système de génération peut être la cause de l'un des problèmes, vous pouvez démarrer, arrêter, ou redémarrer un serveur de builds ou activer ou désactiver un contrôleur ou un agent selon les besoins.Consultez Manage Your Build System.
Fréquemment, lors d'une tentative de résoudre les problèmes de processus de génération, vous devez mettre en file d'attente une génération avec les mêmes options de test à plusieurs reprises des correctifs.Vous pouvez rapidement redémarrer une build :
- D' fenêtre résultats de la génération en choisissant Actions, Recommencer la build.
- D' Page de builds dans Team Explorer ou explorateur de builds en sélectionnant une build terminée, en ouvrant le menu contextuel, et en choisissant Recommencer la build.

Partager via