Share via


Créer une définition de build de base

Après avoir mis un système de génération en place (comme décrit dans Configurer votre système de génération), 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

Pour que vous puissiez effectuer cette procédure, votre autorisation Modifier la définition de build doit avoir la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour créer une définition de build

  1. Dans Team Explorer, cliquez sur le projet d'équipe pour lequel vous souhaitez créer une définition de build.

  2. Dans le menu Générer, cliquez sur Nouvelle définition de build.

    La fenêtre Nouvelle définition de build s'affiche avec l'onglet Général.

  3. Spécifiez le nom à attribuer à la définition de build dans la zone Nom de définition de build.

  4. Dans la boîte de 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).

  5. Cliquez sur l'onglet Valeurs par défaut des builds.

  6. Laissez la case Cette build copie les fichiers de sortie vers un dossier cible activée.

    Notes

    Vos générations échouent si vous désactivez cette case à cocher et que vous utilisez un modèle de génération qui génère un résultat.

  7. Dans la zone Copier la sortie de build dans le dossier de destination suivant, tapez le chemin d'accès de fichier UNC du dossier où vous souhaitez que le système de génération copie des fichiers binaires et des fichiers journaux.

    Important

    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.

  8. Si plusieurs contrôleurs de build s'affichent dans la liste Contrôleur de build, cliquez sur le contrôleur de build que vous souhaitez que le système de génération utilise pour traiter cette définition de build.

  9. 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.

  10. 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, dans la liste Fichier de processus de génération, cliquez sur 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 une build à l'aide du modèle par défaut.

    • Si votre équipe doit utiliser un processus de génération géré par MSBuild, dans la liste Fichier de processus de génération, cliquez sur Modèle de mise à niveau. 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 une build à l'aide du modèle de mise à niveau.

    • Si votre équipe a défini un modèle personnalisé que vous souhaitez utiliser, cliquez sur celui-ci 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. Pour plus d'informations, consultez Créer et utiliser un modèle de processus de génération personnalisé.

  11. Pour s'assurer que les fichiers requis par votre processus de génération sont téléchargés sur l'agent de build, cliquez sur l'onglet Espace de travail, puis réglez les paramètres si nécessaire. Pour plus d'informations, consultez Supprimer une build terminée.

  12. Cliquez sur l'onglet Stratégie de rétention.

    Deux jeux de stratégies de rétention s'affichent dans la liste Spécifier comment les builds doivent être conservées et peuvent être modifiés pour satisfaire les besoins de votre é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.

    • Cliquez sur la valeur dans la colonne Éléments à supprimer et cliquez sur une valeur. Pour plus d'informations sur ces valeurs, consultez Travailler avec des espaces de travail de build.

  13. Lorsque vous avez terminé de travailler sur la définition de build, ouvrez le menu Fichier et cliquez sur Enregistrer <Nom de la définition de build>.

    La définition de build créée s'affiche dans le dossier Builds dans Team Explorer. Pour afficher ou modifier les paramètres de la définition de build, cliquez dessus avec le bouton droit, puis cliquez sur Modifier la définition de build.

Voir aussi

Tâches

Supprimer une définition de build

Autres ressources

Définir votre processus de build