Utilisation de l'Explorateur de builds pour afficher et gérer des builds en file d'attente, en cours et terminées

Vous pouvez utiliser l'Explorateur de builds pour afficher et gérer des détails sur les builds en file d'attente, en cours et terminées. L'onglet En file d'attente permet d'afficher et de gérer les builds mises en file d'attente au cours des cinq dernières minutes. L'onglet Terminé permet d'afficher et de gérer des builds plus anciennes.

Autorisations requises

Pour exécuter cette procédure, les autorisations Afficher les builds, Afficher la définition de build et Afficher les ressources de build doivent avoir la valeur Autoriser. Pour plus d'informations, consultez la rubrique suivante sur le site Web Microsoft : Autorisations Team Foundation Server.

Tâches courantes

Ouvrir l'Explorateur de builds et afficher les résultats de build

Vous pouvez utiliser l'Explorateur de builds pour consulter les builds en file d'attente, en cours d'exécution et terminées. Pour toutes les builds répertoriées, vous pouvez consulter les détails correspondants.

Pour chaque build, les informations suivantes sont disponibles dans l'Explorateur de builds :

Colonne	Description
État/Résultat (icône d'informations)	Indique l'état actuel de la build. Les états valides incluent actif (mis en file d'attente), en cours (en cours d'exécution), arrêté, différé, opération réussie et échec. Pointez sur une icône d'état pour obtenir une description de sa signification.
Définition de build	Nom de la définition de build qui a été utilisée pour mettre la build en file d'attente.
Priorité	Priorité de la build. Remarque Priorité s'affiche uniquement sous l'onglet En file d'attente.
Date de mise en file d'attente	Date et heure de mise en file d'attente de la build. Remarque Date de mise en file d'attente s'affiche uniquement sous l'onglet En file d'attente.
Demandeur	Nom de la personne qui a demandé la génération.
Contrôleur de build	Contrôleur de build utilisé pour exécuter la génération. Remarque Contrôleur de build s'affiche uniquement sous l'onglet En file d'attente.
Conserver indéfiniment (icône de verrou)	Indique que la build doit être conservée indéfiniment et ne doit pas être supprimée alors que la stratégie de rétention indique le contraire. Remarque Conserver indéfiniment s'affiche uniquement sous l'onglet Terminé.
Nom	Nom de la build terminée. Le nom de build se compose de la définition de build concaténée avec le numéro de build. Remarque Nom s'affiche uniquement sous l'onglet Terminé.
Qualité de build	Qualité d'une build terminée. Ce champ est vide jusqu'à ce qu'une qualité de build soit assignée. Remarque Qualité de build s'affiche uniquement sous l'onglet Terminé.
Date d'achèvement	Date et l'heure d'achèvement de la build. Remarque Date d'achèvement s'affiche uniquement sous l'onglet Terminé.

Des détails supplémentaires sont disponibles si vous consultez le rapport de build pour une build spécifique.

Pour ouvrir l'Explorateur de builds

• Dans Team Explorer, développez le projet d'équipe pour lequel vous souhaitez consulter des builds, puis double-cliquez sur le nœud Builds.

  Vous pouvez filtrer la liste de résultats de build pour rechercher plus facilement une build spécifique. Pour plus d'informations, consultez Filtrer les résultats dans l'Explorateur de builds.

Pour consulter les détails d'une build

1. Exécutez l'une des tâches suivantes :

   • Pour consulter des détails d'une build mise en file d'attente récemment, cliquez sur l'onglet En file d'attente.

     Notes

     Si vous actualisez l'onglet après cinq minutes, les builds en file d'attente ne s'affichent plus sous l'onglet En file d'attente. Vous devez consulter à la place l'onglet Terminé.

   • Pour consulter des détails sur une build terminée, ou une build mise en file d'attente il y a plus de cinq minutes, cliquez sur l'onglet Terminé.

2. Dans l'Explorateur de builds, double-cliquez sur la build dont vous souhaitez consulter les détails.

   Un rapport d'informations détaillées sur la build s'affiche dans une nouvelle fenêtre. La barre de titre de la fenêtre se compose de BuildName_BuildNumber, où BuildName est le nom de la définition de build et BuildNumber est le numéro de build.

3. (Facultatif) Vous pouvez exécuter chacune des tâches suivantes à partir du rapport des informations détaillées sur la build :

   • Cliquez sur Afficher le résumé pour consulter un résumé des résultats de build.

   • Cliquez sur Afficher le journal pour consulter les informations enregistrées dans le fichier journal de génération.

   • Cliquez sur Ouvrir le dossier de dépôt pour ouvrir le dossier dans lequel la sortie de génération a été copiée.

   • Cliquez sur Supprimer la build pour supprimer la build du serveur.

     Avertissement

     Vous ne pouvez pas annuler cette opération. Vous ne devez supprimer des builds que si vous êtes certain qu'elles ne sont plus nécessaires. Dans la plupart des organisations, la stratégie de rétention de build est utilisée pour déterminer à quel moment les builds sont supprimées automatiquement. Pour plus d'informations, consultez Spécifier la stratégie de rétention pour la build (Visual Studio Team Foundation Server 2010) ou Spécifier la stratégie de rétention pour la build (Visual Studio Team System 2008 Team Foundation Server).

   • Cliquez sur la liste de critères de qualité de build pour spécifier la qualité de la build terminée.

     Notes

     Vous ne pouvez pas spécifier une qualité de build pour les builds qui ne se sont pas achevées.

Filtrer les résultats dans l'Explorateur de builds

Vous pouvez utiliser les filtres de l'Explorateur de builds pour filtrer les builds terminées par nom de définition de build, qualité de build ou plage de dates pendant laquelle les builds ont été terminées.

Pour filtrer les résultats de build

1. Dans l'Explorateur de builds, cliquez sur l'onglet En file d'attente pour afficher les résultats de builds mises en file d'attente récemment. Pour afficher les builds antérieures ou terminées, cliquez sur l'onglet Terminé.

2. Exécutez l'une des tâches suivantes :

   • Pour rechercher des builds créées à partir d'une définition de build spécifique, dans la zone Définition de build, cliquez sur la définition pour laquelle vous souhaitez consulter les résultats.

   • Pour rechercher des builds d'une qualité spécifique, dans la zone Filtre de qualité, cliquez sur la qualité des builds que vous souhaitez afficher.

   • Pour rechercher des builds qui se sont achevées dans une plage spécifiée de dates, dans la zone Filtre des données, cliquez sur la plage de dates qui correspond à la période voulue.

   La liste de résultats de build est mise à jour immédiatement, à mesure que vous spécifiez des critères de filtre.

Gérer les builds en file d'attente et en cours d'exécution

Une fois qu'une build a été mise en file d'attente et avant qu'elle ne soit terminée, vous pouvez uniquement l'annuler. Vous ne pouvez pas évaluer sa qualité ou la supprimer pendant qu'elle est en file d'attente ou en cours d'exécution.

Pour arrêter une build en cours

• Dans l'Explorateur de builds, cliquez avec le bouton droit sur une build En cours dans l'onglet En file d'attente ou Terminé, puis cliquez sur Arrêter.

Gérer des build terminées

Vous pouvez exécuter diverses actions sur les build terminées. Vous pouvez exécuter ces actions à partir de l'Explorateur de builds ou du rapport de résultats de build pour une build terminée.

Dans cette section

• Évaluer la qualité d'une build terminée

• Mettre une nouvelle build en file d'attente

• Supprimer une build terminée

• Conserver une build indéfiniment

Évaluer la qualité d'une build terminée

Lorsqu'une build est terminée, vous pouvez spécifier la qualité de la build obtenue. Ainsi, vous pouvez communiquer des informations sur la build à votre équipe. Vous pouvez spécifier qu'une build particulière doit être ignorée en la marquant comme étant Rejetée. Vous pouvez spécifier une qualité de build Prêt pour le test initial pour indiquer que le test peut commencer. La liste de critères de qualité de build peut varier pour chaque organisation. Pour plus d'informations sur la personnalisation de la liste de critères de qualité de build, consultez Ajout et suppression des valeurs de qualité de build.

Pour évaluer la qualité de build à partir de l'Explorateur de builds

• Dans l'Explorateur de builds, dans la colonne Qualité de build, cliquez sur la qualité que vous souhaitez assigner à la build spécifiée.

Pour évaluer la qualité de build à partir du rapport de synthèse et d'informations détaillées sur la build

• Dans le rapport de build, cliquez sur la liste de critères de qualité de build pour spécifier la qualité de la build terminée.

Mettre en file d'attente une nouvelle build

Vous pouvez mettre en file d'attente une nouvelle build pour toute génération dont les résultats s'affichent dans l'Explorateur de builds. Vous pouvez également mettre en file d'attente une nouvelle build à partir de Team Explorer. Pour plus d'informations, consultez Exécution et surveillance de builds (Team Explorer Everywhere).

Pour mettre en file d'attente une nouvelle build à partir de l'Explorateur de builds

1. Dans l'Explorateur de builds, cliquez avec le bouton droit sur le résultat de build pour lequel vous souhaitez mettre en file d'attente une nouvelle build et cliquez sur Mettre en file d'attente une nouvelle build.

   Vous pouvez également cliquer sur la build dans les résultats de build, puis cliquer sur Mettre en file d'attente une nouvelle build dans la barre d'outils.

2. Complétez les détails de la boîte de dialogue Mettre en file d'attente la build. Pour plus d'informations, consultez Exécution et surveillance de builds (Team Explorer Everywhere).

Supprimer une build terminée

Si une build terminée n'est plus nécessaire, vous pouvez choisir de la supprimer.

Lorsque vous supprimez une build, les informations suivantes sont supprimées définitivement :

• Détails : informations sur la build terminée affichées dans l'Explorateur de builds. Ces informations incluent les étapes de génération, un demandeur et la date et l'heure de mise en file d'attente. Ces données sont stockées dans la base de données Team Foundation Server.

• Cibles : fichier et dossiers créés par la génération et copiés vers l'emplacement cible.

• Résultats des tests : résultats de tout test automatisé exécuté pendant le processus de génération ou résultats de tout test publié par rapport à cette génération.

• Étiquette : marqueur de contrôle de version associé aux versions de fichiers spécifiques utilisées par le processus de génération.

• Symboles : symboles de débogage publiés sur un serveur de symboles pendant la génération.

Autorisations requises

Pour exécuter cette tâche, l'autorisation Supprimer les builds doit avoir la valeur Autoriser.

Pour supprimer une build terminée

1. Dans l'Explorateur de builds, cliquez sur l'onglet Terminé.

2. Mettez en surbrillance une ou plusieurs builds que vous souhaitez supprimer, cliquez avec le bouton droit sur l'une d'entre elles, puis cliquez sur Supprimer la build.

   Vous pouvez également mettre en surbrillance une ou plusieurs builds, puis cliquer sur Supprimer les builds dans la barre d'outils.

3. Dans la boîte de dialogue de confirmation, cliquez sur OK si vous souhaitez supprimer la ou les builds.

Conserver une build indéfiniment

À chaque définition de build est associée une stratégie de rétention qui spécifie comment les builds doivent être conservées. Vous pouvez substituer cette stratégie de rétention si vous spécifiez qu'une build doit être conservée indéfiniment.

Pour spécifier qu'une build doit être conservée indéfiniment

1. Dans l'Explorateur de builds, cliquez sur l'onglet Terminé.

2. Mettez en surbrillance une ou plusieurs builds que vous souhaitez conserver, cliquez avec le bouton droit sur l'une d'entre elles, puis cliquez sur Conservez indéfiniment.

   Vous pouvez également mettre en surbrillance une ou plusieurs builds, puis cliquer sur Conserver indéfiniment dans la barre d'outils.

   Dans l'Explorateur de builds, une icône de verrou s'affiche en regard des builds conservées indéfiniment. Vous pouvez répéter cette procédure pour supprimer l'indicateur qui indique que la build doit être conservée indéfiniment.

Voir aussi

Autres ressources

Création et utilisation des définitions de build (Team Explorer Everywhere)

Exécution et surveillance de builds (Team Explorer Everywhere)

Génération d'applications (Team Explorer Everywhere)