Création d'une définition de build pour Team System 2008 Team Foundation Server
Pour pouvoir générer votre application, vous devez créer au préalable une définition de build. Une définition de build spécifie les projets Eclipse à compiler et l'emplacement 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 System 2008 Team Foundation Server, vous devez exécuter ces builds manuellement. Pour plus d'informations, consultez Mise en file d'attente d'une build pour Team System 2008 Team Foundation Server.
Pour créer une définition de build pour Visual Studio Team System 2008 Team Foundation Server, 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 quatre types de déclencheur de build avec Team Foundation Server :
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 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 réelle à 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.
Sélectionnez la case d'option Les archivages ne déclenchent pas une nouvelle build.
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.
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.
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.
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 code source 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 nouveau 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 agent 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 Agent 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.
Important
Pour Visual Studio Team System 2008 Team Foundation Server, vous devez copier la sortie de génération dans un dossier de dépôt.
Dans la zone Les builds auront lieu sur le partage suivant, fournissez un chemin d'accès valide à un partage de fichiers Windows (ou à un partage de protocole SMB). 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 Windows (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 nouveau 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).
Si une définition de build doit pouvoir être gérée à 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 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.
Cliquez sur l'onglet Stratégie de rétention.
Dans la zone Spécifier comment les builds doivent être conservées, cliquez sur Stratégie de rétention pour spécifier le nombre de builds qui doivent être conservées pour chaque état de build terminée.
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 en spécifiant Conservez indéfiniment pour une ou plusieurs builds dans l'Explorateur de builds. 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 System 2008 Team Foundation Server.
Voir aussi
Autres ressources
Création d'une définition de build pour Visual Studio 2005 Team Foundation Server
Création d'une définition de build dans Team Foundation Build 2010