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
Tâche |
Contenu de support |
|---|---|
Afficher les résultats de build : vous pouvez ouvrir l'Explorateur de builds pour consulter des informations sur les builds en file d'attente, en cours d'exécution et terminées. |
|
Gérer les builds en file d'attente et en cours d'exécution : vous pouvez arrêter une build en cours, par exemple si vous avez découvert que vous n'avez pas archivé vos modifications avant de demander une génération. |
|
Rechercher des builds spécifiques : vous pouvez appliquer des filtres par définition de build, qualité de build, et en fonction de la date à laquelle les générations ont été effectuées. Ainsi, vous pouvez rechercher plus facilement les builds que vous souhaitez afficher et gérer. |
|
Builds terminées gérées : une fois qu'une build est terminée, vous pouvez en évaluer la qualité. Vous pouvez demander une nouvelle génération pour toute build terminée. Vous pouvez supprimer les build terminées qui ne sont plus nécessaires. Vous pouvez spécifier qu'une build doit être conservée indéfiniment, en tant qu'exception à la stratégie de rétention définie. Par exemple, vous pouvez le faire pour les builds des versions finales. |
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. .gif "Remarque") 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
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é.
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.
(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
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é.
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
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
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.
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.
Avertissement
Lorsque vous supprimez une build, vous supprimez les résultats de test et les fichiers associés. Les données que vous supprimez à l'aide de cette procédure ne peuvent pas être récupérées.
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
Dans l'Explorateur de builds, cliquez sur l'onglet Terminé.
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.
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
Dans l'Explorateur de builds, cliquez sur l'onglet Terminé.
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)