Création d'une définition de build dans Team Foundation Build 2010
Pour pouvoir générer votre application, vous devez créer au préalable une définition de build, qui spécifie les projets Ant ou Maven à compiler et où les builds doivent être créées. Après avoir créé une définition de build, vous pouvez mettre en file d'attente les builds.
Lorsque vous créez des définitions de build pour Visual Studio Team Foundation Server 2010, vous pouvez spécifier le déclencheur qui provoque la mise en file d'attente automatique de la build ou vous pouvez exécuter ces builds manuellement. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team Foundation Server 2010 (Team Explorer Everywhere).
Pour créer une définition de build pour Team Foundation Server 2010, vous devez effectuer les tâches suivantes :
Notes
Vous devez effectuer les sections de ce processus dans l'ordre. La tâche est divisée en plus petites procédures pour améliorer la lisibilité.
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 la page suivante sur le site Web Microsoft : Autorisations Team Foundation Server.
Ouvrir la boîte de dialogue Définition de build
Dans Team Explorer, développez le projet d'équipe pour lequel vous souhaitez créer une définition de build.
Cliquez avec le bouton droit sur le nœud Builds, puis cliquez sur Nouvelle définition de build.
La boîte de dialogue Définition de build s'affiche. L'onglet Général est actif.
Ensuite, spécifiez un nom et une description pour votre définition de build.
Spécifier un nom et une description pour la définition de build
Cliquez sur l'onglet Général.
Dans Nom de définition de build, tapez le nom que vous souhaitez attribuer à la définition de build.
Le nom spécifié doit être unique dans le projet d'équipe.
(Facultatif) Dans la zone Description, fournissez une description pour cette définition de build.
(Facultatif) Si vous souhaitez désactiver cette définition de build, cliquez sur Désactiver cette définition de build.
Par exemple, vous pouvez le faire si vous souhaitez définir une build automatisée, mais que vous n'êtes pas encore prêt pour l'exécution automatique de cette build.
Ensuite, vous spécifiez le déclencheur de build pour définir à quel moment une build doit être exécutée.
Spécifier le déclencheur de build
Vous pouvez spécifier un des cinq types de déclencheur de build avec Team Foundation Server 2010 :
Générer à la demande (déclencheur manuel)
Générer en continu à chaque archivage. Si l'agent de build n'a pas terminé d'exécuter une build antérieure, la nouvelle build est mise en file d'attente.
Chaque archivage doit ajouter une build à la file d'attente et l'exécuter dès qu'un agent est libre. Cette opération peut également être limitée afin qu'un temps minimal entre les builds soit spécifié. Vous pouvez choisir cette option si votre build prend du temps et que vous avez un grand nombre d'archivages qui provoqueraient le placement d'un nombre inacceptable de builds dans la file d'attente de builds.
Builds d'archivage contrôlé. Lorsqu'une build d'archivage contrôlé est créée, les modifications que vous envoyez sont placées dans un jeu de réservations et intégrées automatiquement à votre système de génération. Le processus d'archivage ne sera effectif que si la génération réussit.
Builds planifiées (quotidiennement). Vous pouvez spécifier les jours et l'heure auxquels la build est exécutée. Vous pouvez également forcer l'exécution de la build à l'heure spécifiée, même si aucune modification n'a été apportée dans la période intermédiaire.
Notes
Si vous créez la définition de build sur un ordinateur qui se trouve sur un fuseau horaire différent de celui de l'ordinateur sur lequel les builds s'exécuteront, l'heure à laquelle la build s'exécute peut être inattendue au cours d'une période où l'heure d'été entre ces deux fuseaux horaires est différente.
Pour créer une définition de build déclenchée à la demande
Cliquez sur l'onglet Déclencheur.
Cliquez sur Les archivages ne déclenchent pas une nouvelle build.
Cliquez sur OK pour enregistrer la définition de build sur le serveur.
Vous devez exécuter une build de test pour vérifier que votre définition de build fonctionne comme prévu. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team Foundation Server 2010 (Team Explorer Everywhere).
Pour créer une définition de build générée en continu à partir de chaque archivage
Cliquez sur l'onglet Déclencheur.
Cliquez sur Créer une build à chaque archivage.
Cliquez sur OK pour enregistrer la définition de build sur le serveur.
Vous devez exécuter une build de test pour vérifier que votre définition de build fonctionne comme prévu. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team Foundation Server 2010 (Team Explorer Everywhere).
Pour créer une définition de build générée en continu dès que des agents sont disponibles
Cliquez sur l'onglet Déclencheur.
Cliquez sur Ajouter les archivages jusqu'à ce que la build précédente soit terminée.
(Facultatif) Si vous souhaitez restreindre encore plus la fréquence des builds, activez la case à cocher Générer au moins toutes les. Dans le champ minutes, spécifiez le nombre minimal de minutes qui doivent s'écouler entre les builds.
Cliquez sur OK pour enregistrer la définition de build sur le serveur.
Vous devez exécuter une build de test pour vérifier que votre définition de build fonctionne comme prévu. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team Foundation Server 2010 (Team Explorer Everywhere).
Pour créer une build d'archivage contrôlé
Cliquez sur l'onglet Déclencheur.
Cliquez sur Archivage contrôlé - accepter les archivages uniquement si les modifications envoyées sont fusionnées et générées correctement. Pour plus d'informations sur les archivages contrôlés, consultez Archiver des modifications en attente contrôlées par une build d'archivage contrôlé (Team Explorer Everywhere).
Cliquez sur OK pour enregistrer la définition de build sur le serveur.
Vous devez exécuter une build de test pour vérifier que votre définition de build fonctionne comme prévu. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team Foundation Server 2010 (Team Explorer Everywhere).
Pour créer une définition de build générée à partir d'une planification spécifiée
Cliquez sur l'onglet Déclencheur.
Cliquez sur Générer toutes les semaines les jours suivants.
Activez les cases à cocher qui correspondent aux jours où vous souhaitez que la build s'exécute.
Dans la zone Mettre la build en file d'attente sur l'agent de build par défaut à, spécifiez l'heure à laquelle vous souhaitez que la build soit mise en file d'attente.
(Facultatif) Activez la case à cocher Générer même si rien n'a été modifié depuis la dernière build.
Cliquez sur OK pour enregistrer la définition de build sur le serveur.
Vous devez exécuter une build de test pour vérifier que votre définition de build fonctionne comme prévu. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team Foundation Server 2010 (Team Explorer Everywhere).
Ensuite, spécifiez les dossiers de travail que vous souhaitez inclure dans la build.
Spécifier les dossiers de travail à inclure dans la build
Sous cet onglet, vous spécifiez les dossiers à inclure dans la build. Chaque chemin d'accès est mappé à un emplacement relatif sous un répertoire de build racine sur l'agent de build qui est référencé en tant que $(SourceDir). L'agent de build sera exécuté sur un système d'exploitation Windows. Par conséquent, les chemins d'accès relatifs de dossiers locaux doivent être fournis en utilisant les conventions d'affectation de noms pour les répertoires Windows. Par exemple, vous devez utiliser la barre oblique inverse (\) en tant que séparateur de chemins d'accès.
Par défaut, l'ensemble du projet d'équipe est inclus, mais vous devez envisager d'inclure uniquement les dossiers qui sont nécessaires pour votre définition de build. Ainsi, vous pouvez réduire le nombre de fichiers téléchargés à partir du contrôle de version pour exécuter la build.
Cliquez sur l'onglet Espace de travail.
Pour modifier les dossiers de travail, exécutez l'une des tâches suivantes :
Pour copier une autre définition d'espace de travail Team Foundation Server, cliquez sur Copier un espace de travail existant, puis spécifiez l'espace de travail que vous souhaitez copier.
Pour ajouter un dossier de travail, cliquez sur Cliquez ici pour entrer un nouveau dossier de travail. Spécifiez un Dossier de contrôle de code source, ainsi qu'un Dossier local pour chaque dossier de travail que vous ajoutez. Vous pouvez cliquer sur Parcourir (...) pour spécifier les dossiers.
Pour supprimer un dossier de travail, cliquez avec le bouton droit sur le dossier à supprimer, puis cliquez sur Supprimer.
Ensuite, spécifiez les paramètres par défaut pour la build.
Spécifier les paramètres par défaut pour la build
Vous devez spécifier un contrôleur de build et un emplacement cible où la sortie de génération aura lieu.
Cliquez sur l'onglet Valeurs par défaut des builds.
Dans la zone Contrôleur de build, spécifiez l'agent de build que vous souhaitez utiliser pour la définition de build.
Activez la case à cocher Cette build copie les fichiers de sortie vers un dossier cible si elle n'est pas déjà activée.
Dans la zone Des builds intermédiaires seront créées sur le partage suivant, fournissez un chemin d'accès valide à un partage de fichiers Windows (ou à un partage Samba). Le serveur de builds copiera la sortie de génération vers ce chemin d'accès.
Vous devez spécifier le chemin d'accès au format UNC (convention d'affectation de noms uniforme), tel que \\Nom de serveur\Partage.
Ensuite, vous spécifiez l'emplacement du fichier projet.
Spécifier l'emplacement du fichier projet
Team Foundation Build utilise un script MSBuild nommé TFSBuild.proj pour contrôler le processus de génération. Utilisez l'onglet Fichier de profil pour rechercher un dossier TFSBuild.proj existant dans le contrôle de version ou créer un fichier TFSBuild.proj que vous associez à la définition de build. Si plusieurs définitions de build partagent un fichier TFSBuild.proj, sa personnalisation affecte chaque définition de build.
Vous pouvez spécifier un dossier qui contient un fichier TFSBuild.proj existant, ou vous pouvez créer un fichier TFSBuild.proj à partir d'un fichier de build Ant existant (Build.xml) ou d'un modèle POM (Project Object Model) Maven (pom.xml).
Si vous devez gérer une définition de build à partir d'un client Visual Studio 2005, vous devez stocker le fichier projet dans un dossier appelé TeamBuildTypes à la racine du projet d'équipe sous contrôle de version. Si tous les collaborateurs de la build comptent utiliser Visual Studio 2008, Visual Studio 2010 ou le Plug-in Team Foundation Server pour Eclipse, le dossier de build peut exister n'importe où dans le projet d'équipe sous contrôle de version.
Pour spécifier un fichier TFSBuild.proj existant
Cliquez sur l'onglet Fichier projet.
Cliquez sur Parcourir et spécifiez le dossier de contrôle de version qui contient le fichier TFSBuild.proj que vous souhaitez utiliser.
Pour créer un fichier TFSBuild.proj
Cliquez sur l'onglet Fichier projet.
Cliquez sur Parcourir pour spécifier le dossier de contrôle de version dans lequel vous souhaitez que le nouveau fichier TFSBuild.proj soit créé.
Cliquez sur Créer.
L'Assistant Création d'une configuration de build s'affiche.
Dans la liste Assistants, cliquez sur Configuration MSBuild à partir d'un fichier de build Ant existant ou Configuration MSBuild à partir d'un fichier POM Maven existant.
Cliquez sur Suivant.
Dans la zone Fichier de build, spécifiez le fichier de build Ant ou le fichier POM Maven sur le serveur de contrôle de version.
Cliquez sur Terminer.
Un nouveau fichier TFSBuild.proj est créé à partir du fichier de build Ant ou du fichier POM Maven.
Ensuite, spécifiez une stratégie de rétention de build pour indiquer la durée de conservation des builds.
Spécifier la stratégie de rétention pour la build
Pour chaque état de builds terminées, vous pouvez spécifier plusieurs builds de ce type qui seront conservées automatiquement. Pour les builds que vous définissez pour Team Foundation Server 2010, vous pouvez spécifier une stratégie de rétention pour les builds déclenchées et manuelles et une autre stratégie pour les builds privées.
Cliquez sur l'onglet Stratégie de rétention.
Sous Stratégie de rétention, cliquez sur l'option appropriée en regard de chaque état de build pour spécifier le nombre de builds qui doivent être conservées.
Vous pouvez cliquer sur Spécifier le nombre à conserver, puis spécifier un nombre spécifique de builds si aucune des valeurs fournies ne répond à vos besoins.
Notes
Les utilisateurs peuvent substituer la stratégie de rétention d'une ou plusieurs builds dans l'Explorateur de builds en spécifiant Conserver indéfiniment. Pour plus d'informations, consultez Conserver une build indéfiniment.
Enregistrer la définition de build
Dans la boîte de dialogue Définition de build, cliquez sur OK.
La définition de build est enregistrée sur le serveur.
Vous devez exécuter une build de test pour vérifier que votre définition de build fonctionne comme prévu. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team Foundation Server 2010 (Team Explorer Everywhere).
Voir aussi
Autres ressources
Création et utilisation des définitions de build (Team Explorer Everywhere)
Création d'une définition de build pour Visual Studio 2005 Team Foundation Server
Création d'une définition de build pour Team System 2008 Team Foundation Server