Créer une définition de build

Après avoir mis un système de génération en place (comme décrit dans Setting up and Managing a Build System), vous êtes presque prêt à commencer à utiliser Team Foundation Build pour compiler votre code, effectuer vos tests, et exécuter de nombreuses autres fonctions importantes.L'étape suivante consiste à créer une définition de build.Une définition de build contient vos instructions sur les projets de code à compiler, les opérations supplémentaires à exécuter, et comment les exécuter.

Autorisations requises

Vous devez disposer de l'autorisation Modifier la définition de build à Autoriser.Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour créer une définition de build

1. Dans l'Explorateur d'équipes :

   1. Si vous n'êtes pas déjà connecté au projet d'équipe dans lequel vous souhaitez travailler, connectez-vous au projet d'équipe.

   2. Sélectionnez Home, puis Builds.

   3. Sur la page Builds, choisissez Nouvelle définition de build.

   Une nouvelle fenêtre de définition de build s'affiche.

2. Sur l'onglet Général.

   • Spécifiez le nom à attribuer à la définition de build dans la zone Nom de définition de build.Consultez Restrictions d'affectation de noms dans Team Foundation.

   • Dans la boîte Description, ajoutez une description appropriée.Cette description fournit les informations supplémentaires aux membres de votre équipe lorsqu'ils vont mettre en file d'attente une build manuellement (comme décrit dans Mettre une build en file d'attente).

3. Si votre processus de génération n'est pas encore prêt pour que votre équipe utilise, sur onglet Général, sous traitement de la file d'attente, vous pouvez modifier les paramètres par défaut Activé par :

   • en pause pour permettre au systeme d'autoriser des nouveaux builds a être mis en file d'attente par des déclencheurs ou des utilisateurs, dans un état posé.

   • désactivé pour faire en sorte que le système évite que les nouveaux builds soient mis en file d'attente par des déclencheurs ou des utilisateurs.

4. Cliquez sur l'onglet Déclencheur et spécifiez l'événement qui doit provoquer l'exécution de cette définition de build.Pour plus d'informations, consultez Spécifier les raisons et les déclencheurs de build.

5. Sous l'onglet Espace de travail , dans la table Dossiers de travail , spécifiez les dossiers de contrôle de version qui contiennent les fichiers que votre processus de génération requiert.

   Conseil
   Pour vous assurer que votre build traite les fonctions correctement et pour améliorer les performances, incluez tous les dossiers, et seulement ces dossiers, qui contiennent que votre processus de build requierent.Pour plus d'informations sur comment spécifier ces dossiers, consultez Travailler avec des espaces de travail de build.

6. Sous l'onglet de Valeurs par défaut des builds, si plusieurs contrôleurs de build apparaît dans la liste Contrôleur de build, choisissez contrôleur de build que vous souhaitez que le système de génération pour utiliser pour traiter cette définition de build.

   Si votre collection de projets d'équipe est hébergée Service Team Foundation sur et de votre équipe peuvent les besoins être rencontrés par un agent de build standard unique, sélectionnez Contrôleur de build hébergé.Consultez l' Utilisez le contrôleur de build hébergé dans une collection de projets d'équipe hébergée sur le service Team Foundation

7. Sur l'onglet Valeurs par défaut des builds, choisissez l'une des options suivantes d'emplacement temporaire afin de spécifier la façon dont vous souhaitez que le processus de build génère et enregistre les fichiers de sortie tels que les fichiers binaires compilés et les fichiers de log:

   • Ce build ne copie pas les fichiers de sortie vers un dossier de dépôt: Choisissez cette option si vous n'avez pas besoin de fichiers de sortie.

   • Copier la sortie du build dans le dossier de dépôt suivant: Choisissez cette option si vous souhaitez copier les fichiers de sortie vers un dossier de dépôt sur un serveur de partage de fichiers.Dans la zone, tapez le chemin d'accès UNC du dossier dans lequel vous souhaitez que le système de build mette à jour les fichiers de sortie.Vous devez spécifier un dossier qui a été préparé pour une utilisation comme dossier de dépôt.Pour plus d'informations, consultez Configurer des dossiers de dépôt.

   • Copiez la sortie de génération au dossier suivant de contrôle de code source: Choisissez cette option si vous souhaitez copier des fichiers de sortie vers un dossier de dépôt dans le contrôle de version.Dans la zone, tapez le chemin d'accès au répertoire (ou choisissez … pour rechercher le dossier) où vous souhaitez que le système de génération pour mettre à jour les fichiers de sortie.Vous devez prendre soin en spécifiant ce dossier, et il existe des contraintes sur lequel des dossiers vous pouvez spécifier.Pour plus d'informations, consultez Configurer des dossiers de dépôt.

8. Cliquez sur l'onglet Processus et spécifiez les détails relatifs aux fonctions que cette build exécute et leur mode d'exécution :

   • Pour définir une build rapidement et facilement, choisissez Afficher les détails, puis dans la liste fichier de processus de génération , choisissez Modèle par défaut.Passez en revue les valeurs des paramètres du processus de génération et, au besoin, modifiez-les.Pour plus d'informations, telles que des explications des Paramètres du processus de génération et comment les utiliser, consultez Définir un processus de build basé sur le modèle par défaut.

   • Si votre équipe a défini un modèle personnalisé que vous souhaitez utiliser, sélectionnez Afficher les détails, puis, sélectionnez le modèle dans la liste fichier de processus de génération .Passez en revue les valeurs des paramètres du processus de génération et, au besoin, modifiez-les.Sinon, vous pouvez créer votre propre processus de build personnalisé.Pour plus d'informations, consultez Créer et utiliser un modèle de processus de génération personnalisé.

9. Sous l'onglet Stratégie de rétention vous pouvez spécifier le nombre de builds terminées que vous souhaitez conserver.Vous pouvez modifier deux jeux de polices de rétention dans la liste Spécifier comment les builds doivent être conservées et pour satisfaire les besoins de vôtre équipe:

   • Le groupe des stratégies Déclenchée et manuelle limite ce que le système conserve des builds mises en file d'attente soit manuellement ou par un déclencheur automatique.

   • Le groupe de stratégies Privé limite ce que le système conserve des builds qui ont été mises en file d'attente manuellement à partir du code source dans un jeu de réservations (comme cela est décrit dans Mettre une build en file d'attente).

   Pour modifier une stratégie de rétention pour les builds terminées dont le statut est Interruption, Échec, Succès partiel, ou Opération réussie, exécutez une des étapes suivantes ou les deux :

   • Cliquez sur la valeur dans la colonne Stratégie de rétention et cliquez sur l'une des options suivantes : Tout conserver,, Conserver la dernière seulement,, Conserver les 2 dernières,, Conserver les 5 dernières,, Conserver les 7 dernières,, Conserver les 10 dernières ou Spécifier le nombre à conserver.

   • Choisisez la valeur dans la colonne Éléments à supprimer et choisissez une valeur.Pour plus d'informations sur ces valeurs, consultez Supprimer une build terminée.

10. Lorsque vous avez fini de travailler sur la définition de build, dans le menu Fichier choisissez Enregistrer<Nom de la définition de build>.

    La définition de build que vous avez créée apparaît sur la page Builds dans Team Explorer.Pour plus d'informations, consultez Exécuter, surveiller et gérer des builds.