Comment : créer une définition de build
Mise à jour : novembre 2007
Team Foundation Build utilise des définitions de build pour configurer les conditions dans lesquelles une solution unique ou un ensemble de solutions dans un projet d'équipe sera généré. Pour générer une build, vous devrez créer une définition de build ou en utiliser une existante.
Lorsque vous créez des définitions de build à l'aide de la boîte de dialogue Définition de build, vous pouvez définir plusieurs options. Parmi ces options figurent le nom de la build, l'espace de travail du contrôle de code source pour les fichiers à générer, l'emplacement du fichier projet TFSBuild.proj, ainsi que l'agent, la stratégie de rétention et le déclencheur de build. Si vous n'avez pas de fichier projet MSBuild existant, vous pouvez utiliser la boîte de dialogue Définition de build pour lancer l'Assistant Création de fichier de projet MSBuild pour créer un fichier TFSBuild.proj correspondant à votre définition de build. Vous pouvez également ouvrir la boîte de dialogue Propriétés de l'agent de build pour créer un agent de build.
Après avoir créé une définition de build, vous pouvez en modifier les options. Pour plus d'informations, consultez Comment : modifier une définition de build.
Vous pouvez personnaliser vos définitions de build en modifiant le fichier TFSBuild.proj enregistré au format MSBuild. Pour plus d'informations, consultez Personnalisation de Team Foundation Build.
Pour supprimer une définition de build, commencez par supprimer les builds associées à cette définition. Puis, la définition elle-même peut être supprimée. Pour plus d'informations, consultez Comment : supprimer une définition de build.
Autorisations requises
Pour exécuter cette procédure, vous devez disposer de l'autorisation Administrer une build avec la valeur Autoriser. En outre, le compte de service de couche Application et le compte de service Team Foundation Build doivent avoir des autorisations de lecture/écriture sur l'emplacement cible de la build. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
Pour créer une définition de build
Dans l'Explorateur d'équipes, sélectionnez le projet pour lequel vous souhaitez créer une définition de build.
Dans le menu Générer, sélectionnez Nouvelle définition de build.
La boîte de dialogue Définition de build apparaît avec l'onglet Général sélectionné.
.gif "Conseil")
Conseil :Les onglets affichant une icône d'avertissement requièrent l'entrée de données.
Spécifiez le nom attribué à la définition de build dans la zone de texte Nom de définition de build.
Le nom que vous entrez doit être un nom de fichier Windows unique et valide.
Ajoutez une description appropriée dans la zone de texte Description.
Cette description apparaît dans la boîte de dialogue Mettre en file d'attente la build "<nom du projet d'équipe>". Pour plus d'informations, consultez Comment : démarrer ou mettre en file d'attente une définition de build.
Cliquez sur l'onglet Espace de travail.
Le tableau Dossiers de travail inclut par défaut le dossier du contrôle de code source pour le projet d'équipe pour lequel vous créez les définitions de build et un dossier local dans l'agent de build. Le dossier local de l'agent de build est répertorié dans la colonne Dossier local. Tous les chemins d'accès aux espaces de travail de l'agent de build sont mappés en fonction du répertoire racine par défaut affiché.
Pour copier un espace de travail existant vers la liste de dossiers de travail, cliquez sur le bouton Copier l'espace de travail existant pour ouvrir la boîte de dialogue Sélectionner un espace de travail.
L'espace de travail que vous sélectionnez devient un enfant du répertoire racine commun dans l'agent de build.
Vous pouvez également cliquer sur une cellule vide du tableau dans Dossier du contrôle de code source, puis cliquez sur le bouton de sélection (...) pour naviguer jusqu'au dossier du contrôle de code source à ajouter comme dossier de travail. Le dossier du contrôle de code source que vous sélectionnez est également fonction du répertoire racine commun de l'agent de build.
Cliquez sur l'onglet Fichier projet. Dans le volet Fichier projet, vous pouvez naviguer jusqu'à un fichier projet TFSBuild.proj existant ou lancer l'Assistant Création de fichier de projet MSBuild pour créer un fichier TFSBuild.proj.
Pour naviguer jusqu'à un dossier TFSBuild.proj existant, cliquez sur Parcourir. Dans la boîte de dialogue Rechercher un dossier, sélectionnez une définition de build existante dans le dossier TeamBuildTypes, puis cliquez sur OK.
Le fichier TFSBuild.proj est maintenant partagé entre la nouvelle définition de build et l'existante.
Si un fichier TFSBuild.proj a été trouvé, le texte Le fichier de projet MSBuild a été trouvé : TFSBuild.proj s'affiche dans le volet Fichier projet. Si un fichier projet est introuvable, le volet Fichier projet affiche un avertissement et vous recommande de créer un fichier projet MSBuild.
.gif "Remarque importante")
Remarque importante :Toute modification apportée à un fichier TFSBuild.proj partagé personnalise toutes les définitions de build auxquelles le fichier est associé. Pour plus d'informations, consultez Personnalisation de Team Foundation Build.
Pour créer un fichier projet pour votre définition de build, cliquez sur Créer. L'Assistant Création de fichier de projet MSBuild apparaît.
Sur la page Sélectionnez et classez les solutions à générer, sélectionnez les solutions à générer. Pour trier les solutions, sélectionnez-en une et utilisez les touches de direction situées à droite de la liste pour modifier sa position dans l'ordre de la génération.
Attention :Tenez compte des dépendances d'une solution vis-à-vis d'une autre lorsque vous déterminez l'ordre de la génération des solutions. Par exemple, si Solution2 a une dépendance vis-à-vis de Solution1, placez Solution1 avant Solution2.
Cliquez sur Next.
La page Sélectionnez les configurations à générer apparaît.
Dans la grille sous Quelles configurations souhaitez-vous générer ?, sélectionnez la configuration et les plateformes à inclure dans vos définitions de build. La configuration de génération indique la configuration et la plateforme souhaitées (par exemple, Release et AnyCPU).
Remarque :Si vous créez une définition de build pour des projets Web, sélectionnez Plateformes mixtes dans le menu déroulant Plateforme.
Cliquez sur Next.
La page Sélectionnez les options de build apparaît.
Indiquez les options de build que vous souhaitez sélectionner en activant les cases à cocher Série de tests(par exemple, exécution de tests de vérification (BVT) de la génération, etc.) et Exécuter l'analyse du code, le cas échéant. Si la case à cocher Série de tests (par exemple, exécution de tests de vérification (BVT) de la génération, etc.) est activée, utilisez les listes déroulantes pour spécifier les options Fichier de métadonnées de test et Liste de tests à exécuter, si approprié.
Pour plus d'informations, consultez Utilisation des listes de test et Écriture de code de qualité..
Remarque importante :Pour réaliser des tests, Team Edition for Testers doit être installé sur l'agent de build. Pour effectuer l'analyse du code, Visual Studio Team Edition for Developers doit être installé sur l'agent de build.
Cliquez sur Terminer.
Le volet Fichier projet de la boîte de dialogue Définition de build apparaît. Le fichier TFSBuild.proj que vous avez créé est stocké sous $<Projet d'équipe>\TeamBuild Types\<Nom de la définition de build>\TFSBuild.proj dans le contrôle de code source.
Cliquez sur l'onglet Stratégie de rétention. Dans la liste Spécifier comment les builds doivent être conservées, vous pouvez sélectionner la stratégie de rétention pour les builds non réussies, arrêtées, partiellement réussies et parfaitement réussies. Sélectionnez une stratégie de rétention dans la liste déroulante. Si vous sélectionnez <Spécifier le nombre à conserver>, la boîte de dialogue Nombre de builds apparaît. Dans la zone de texte Spécifier le nombre de builds à conserver, indiquez combien de builds vous souhaitez garder pour le résultat de build spécifié.
Cliquez sur l'onglet Valeurs par défaut des builds. Dans le volet Valeurs par défaut des builds, vous pouvez choisir un agent de build existant dans la liste déroulante Agent de build. Si aucun agent de build n'existe ou vous souhaitez en créer un, cliquez sur Nouveau. La boîte de dialogue Propriétés de l'agent de build s'affiche. Complétez les zones de texte Nom complet, Description et Nom d'ordinateur et cliquez sur OK. Pour plus d'informations, consultez Comment : créer et gérer des agents de build.
Dans la zone de texte Les builds auront lieu sur le partage suivant (par exemple, \\serveur\partage), tapez l'emplacement UNC (\\serveur\partage). Les fichiers binaires et journaux créés seront enregistrés dans ce dossier une fois la build terminée.
Remarque :Avant de procéder à cette étape, vous avez dû créer un dossier public sur l'ordinateur d'agent de build où le compte TFSService a des droits complets. Pour plus d'informations sur les comptes de service Team Foundation, consultez Comment : afficher les services Team Foundation Server.
Cliquez sur l'onglet Déclencheur.
Dans le volet Déclencheur, sélectionnez Les archivages ne déclenchent pas une nouvelle build pour les builds à la demande uniquement.
Sélectionnez Générer chaque archivage (plus de builds) pour générer une build à chaque archivage d'une modification apportée aux fichiers spécifiés dans votre définition de build.
Sélectionnez Accumuler les archivages jusqu'à ce que la build précédente se termine (moins de builds) pour créer des builds enchaînées. Si la case à cocher Accumuler les archivages jusqu'à ce que la build précédente se termine (moins de builds) est activée, vous pouvez indiquer l'intervalle entre les builds en activant la case à cocher Générer au maximum toutes les et en entrant un nombre dans la zone de texte minutes.
La plage valide pour la zone de texte minutes s'étend de 0 à 2147483647 (Int32 MaxValue).
Remarque :Si vous utilisez Visual Studio Team System 2008 Team Foundation Server avec le Service Pack 1, vous pouvez définir l'intervalle de builds enchaînées entre 120 et 240 minutes. Si vous utilisez Visual Studio Team System 2008 Team Foundation Server sans le Service Pack 1, Team Foundation Build ignore toute valeur dans cette plage.
Sélectionnez Générer chaque semaine les jours suivants pour créer des builds planifiées. Sélectionnez chaque jour où générer des builds à l'aide des cases à cocher en regard de chaque jour de la semaine. Indiquez l'heure de build dans la zone de texte Mettre la build en file d'attente sur l'agent de build par défaut à.
Remarque :Les builds planifiées ne seront pas générées si aucune modification n'a été archivée depuis la dernière build.
Cliquez sur OK pour créer votre définition de build une fois que vous avez fourni toutes les informations requises.
La définition de build créée apparaît dans le dossier Builds de Team Explorer. Pour consulter les informations stockées sur le serveur pour votre définition de build, cliquez dessus avec le bouton droit dans Team Explorer et cliquez sur Modifier la définition de build. La boîte de dialogue Définition de build s'ouvre et affiche les informations que vous avez entrées. Vous pouvez les modifier. Pour plus d'informations, consultez Comment : modifier une définition de build.
Remarque importante :Si votre définition de build partage un fichier TFSBuild.proj avec une autre build, votre définition et les fichiers associés n'apparaissent pas dans l'Explorateur du contrôle de code source sous le dossier TeamBuildTypes. Seule la définition de build initiale est répertoriée.
Voir aussi
Tâches
Procédure pas à pas : création d'une définition de build dans Team Foundation Build
Comment : établir des autorisations pour un agent Team Foundation Build
Comment : configurer et installer Team Foundation Build
Procédure pas à pas : personnalisation de Team Foundation Build avec une tâche personnalisée
Concepts
Vue d'ensemble de Team Foundation Build
Autres ressources
Utilisation de définitions de build dans Team Foundation Build