Créer ou modifier une définition de build

Après avoir déployé votre système de génération, vous êtes prêt à définir un processus de génération qui compile votre code et exécute vos tests, ainsi que de nombreuses autres fonctions importantes pour votre équipe.

1. À partir de Visual Studio, Team Explorer, vérifiez que vous êtes connecté au projet d'équipe (raccourci clavier : Ctrl+0, C), puis ouvrez Builds (raccourci clavier : Ctrl+0, B).

2. Cliquez sur le lien Nouvelle définition de build ou sélectionnez une build, ouvrez le menu contextuel, puis choisissez Modifier la définition de build.

   Conseil

   Si un message d'erreur TF225001 s'affiche, configurez un contrôleur de build.

3. Sous 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.

   • (Facultatif) Dans la zone 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).

4. Si votre processus de génération n'est pas encore prêt pour que votre équipe l'utilise, sous l'onglet Général, sous Traitement de la file d'attente, vous pouvez modifier le paramètre par défaut Activé en :

   • Suspendu qui permet aux nouvelles builds d'être mises en file d'attente par les déclencheurs ou les utilisateurs, mais de les laisser dans un état suspendu ;

   • Désactivé, qui empêche de nouvelles builds d'être mises en file d'attente par des déclencheurs ou des utilisateurs.

5. Sous l'onglet Déclencheur, spécifiez l'événement qui doit provoquer l'exécution de cette définition de build. Consultez Spécifier les raisons et les déclencheurs de build.

6. Sous l'onglet Paramètres de la source :

   • TFVC : dans la table Dossiers de travail, spécifiez les dossiers de contrôle de version qui contiennent les fichiers que requiert votre processus de génération.

     Conseil

     Pour vous assurer que votre build traite les fonctions correctement et pour améliorer les performances, incluez tous les dossiers, et seulement ceux-ci, qui contiennent les fichiers que requiert votre processus de génération.Consultez Travailler avec des espaces de travail de build.

   • Git : spécifiez le référentiel et les branches qui contiennent les fichiers requis par votre processus de génération.

     Conseil

     Dans la liste des branches surveillées pour l'intégration continue et les builds enchaînées, vous pouvez utiliser des caractères génériques.Par exemple, vous pouvez indiquer refs/heads/feature* pour surveiller les branches refs/heads/featureA et refs/heads/featureB.

7. Sous l'onglet Valeurs par défaut des builds, 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.

   Si votre collection de projets d'équipe est hébergée sur Visual Studio Online et que les besoins de votre équipe peuvent être satisfaits par un seul agent de build standard, sélectionnez Contrôleur de build hébergé. Voir Contrôleur de build hébergé.

8. Sous l'onglet Valeurs par défaut des builds, choisissez l'une des options suivantes d'emplacement intermédiaire afin de spécifier la façon dont vous souhaitez que le processus de génération produise et enregistre les fichiers de sortie, tels que les fichiers binaires compilés et les fichiers journaux :

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

   • Copier la sortie de la build dans le dossier cible suivant : choisissez cette option si vous souhaitez copier les fichiers de sortie dans un dossier cible d'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. Consultez Configurer des dossiers de dépôt.

   • Copier sur le serveur la sortie de la génération : sélectionnez cette option pour copier la sortie générée dans votre Team Foundation Server.

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

   • Pour définir une build simple, choisissez Afficher les détails, puis dans la liste Fichier de processus de génération, choisissez Modèle par défaut. Consultez Utiliser le modèle par défaut pour un processus de build.

   • 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. Consultez Personnaliser votre modèle de processus de génération.

10. 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 stratégies de rétention dans la liste Spécifier comment les builds doivent être conservées et répondre aux 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 :

    • Choisissez la valeur dans la colonne Stratégie de rétention et choisissez 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.

    • Choisissez 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.

11. Quand vous avez fini de travailler sur la définition de build, dans le menu Fichier, sélectionnez Enregistrer <Nom de la définition de build> (raccourci clavier : Ctrl + S).

    La définition de build créée apparaît sur la page Builds dans Team Explorer. Consultez Exécuter, surveiller et gérer des builds.