Définir une build à l'aide du modèle par défaut
Vous pouvez utiliser le modèle par défaut pour définir rapidement une build de base en sélectionnant les projets de code que vous souhaitez générer. Vous pouvez également utiliser ce modèle pour inclure davantage de fonctionnalités avancées (telles que l'exécution de tests automatisés) et pour ajuster plusieurs aspects du processus de génération afin de satisfaire les besoins de votre équipe.
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 à l'aide du modèle par défaut
Dans Team Explorer, cliquez sur le projet d'équipe dans lequel vous voulez définir votre build.
Dans le menu Générer, cliquez sur Nouvelle définition de build.
Dans Nom de définition de build, tapez un nom.
Cliquez sur l'onglet Processus.
Sous Modèle de processus de génération, le Modèle par défaut est sélectionné par défaut.
Sous Paramètres du processus de génération, développez le nœud Requis et spécifiez au moins une solution ou un projet à générer.
Pour plus d'informations, consultez Spécifier les projets à générer plus loin dans cette rubrique.
Utilisez les informations ultérieures de cette rubrique pour renseigner les champs qui fournissent les fonctionnalités que vous souhaitez placer dans cette définition de build.
Une fois que vous avez rempli les champs sous l'onglet Processus, complétez les champs des onglets Déclencheur, Espace de travail, Valeurs par défaut des builds et Stratégie de rétention.
Pour plus d'informations, consultez Spécifier les raisons et les déclencheurs de build, Travailler avec des espaces de travail de build et Créer une définition de build de base.
Dans cette rubrique
À propos des paramètres du processus de génération du modèle par défaut
Spécifier les projets à générer
Spécifier les plateformes et configurations à générer
Spécifier les agents de build qui traitent votre build
Spécifier des limites de temps pour l'agent de build
Exécuter des tests automatisés et activer l'analyse d'impacts des tests
Spécifier les paramètres du processus de génération de base
Spécifier les paramètres avancés du processus de génération
À propos des paramètres du processus de génération du modèle par défaut
Cette rubrique explique comment définir une build à l'aide des paramètres de processus de génération des builds basées sur le modèle par défaut. Les informations dans cette rubrique décrivent les fonctionnalités qui doivent correspondre à celles de Visual Studio Application Lifecycle Management (ALM) dans la mesure où les conditions suivantes sont remplies :
Vous travaillez dans un projet d'équipe créé à partir d'un des deux modèles de processus inclus dans Visual Studio ALM : MSF for Agile Software Development v5.0 ou MSF for CMMI Process Improvement v5.0.
Personne, dans votre équipe, n'a supprimé ni personnalisé le modèle par défaut.
Spécifier les projets à générer
Dans la zone Projets à générer, vous pouvez spécifier un ou plusieurs projets ou solutions à générer. (Pour afficher cette zone, développez le nœud Requis, puis développez le nœud Éléments à générer.) Vous devez spécifier au moins une solution ou un projet.
Si vous générez plusieurs projets connexes, vous devez généralement les ajouter à une solution unique et spécifier cette solution dans la zone Projets à générer au lieu de répertorier chaque projet séparément.
Dans le champ Projets à générer, vous pouvez cliquer sur le bouton de sélection (...) pour ouvrir et utiliser la boîte de dialogue Solutions/Projets afin de spécifier des solutions ou des projets à générer.
Pour remplir la zone Projets à générer manuellement, spécifiez le chemin d'accès au contrôle de version complet de chaque projet ou solution que vous souhaitez générer. Vous délimitez chaque valeur par une virgule, comme l'illustre l'exemple suivant :
$/Features/FeatureA/Server/All Server Projects.sln, $/Features/FeatureA/Client/All Client Projects.sln
Important
Assurez-vous que le chemin d'accès de chaque projet ou solution est un enfant de l'une des valeurs Dossier du contrôle de code source répertoriées sous l'onglet Espace de travail de la définition de build.
Spécifier les plateformes et configurations à générer
Dans la zone Configurations à générer, vous pouvez spécifier les plateformes et configurations que vous souhaitez générer. (Pour afficher cette zone, développez le nœud Requis, puis développez le nœud Éléments à générer.) Par exemple, vous pouvez spécifier que cette build doit générer uniquement la configuration Release de la version 32 bits de votre projet C++ en incluant Version finale|x86 dans cette zone.
Conseil
Si vous possédez un grand code base, vous pouvez augmenter considérablement la vitesse de traitement de la build en générant uniquement les configurations et plateformes dont vous avez besoin.
Si vous ne remplissez pas la zone Configurations à générer, la configuration et la plateforme par défaut définies dans chaque solution ou projet sont générées.
Dans le champ Éléments à générer, vous pouvez cliquer sur le bouton de sélection (...) pour ouvrir et utiliser la boîte de dialogue Configurations pour spécifier les éléments à générer. Vous pouvez également les spécifier manuellement.
Chaque configuration de la zone Configurations à générer doit se présenter sous la forme suivante :
Configuration|Plateforme
Vous devez remplacer les espaces réservés suivants :
Configuration est une valeur telle que Débogage, Version finale ou Toutes les configurations.
Plateforme est une valeur telle que Win32, x86, x64 ou Any CPU.
Les configurations de la liste doivent être séparées par des virgules.
Par exemple, pour générer à la fois la configuration Débogage et Version finale de votre projet C#, vous spécifiez Débogage|Any CPU, Version finale|Any CPU dans la zone Configurations à générer.
Les jetons que vous utilisez pour la configuration et la plateforme doivent correspondre aux jetons configurés dans vos propriétés de solution ou de projet de code. S'ils ne correspondent pas, vous risquez d'obtenir des résultats inattendus une fois la build terminée.
Spécifier les agents de build qui traitent votre build
Pour spécifier quels agents de build sont utilisés pour traiter votre build développez le nœud Avancé, développez le nœud Paramètres d'agent, puis spécifiez les valeurs des paramètres suivants :
Filtre de nom : vous pouvez filtrer les agents de build utilisés pour traiter cette définition de build en tapant le nom d'un agent dans ce champ. Vous pouvez également spécifier un ensemble de noms à l'aide des caractères génériques * et ?. Par exemple, vous pouvez indiquer CI* pour spécifier tous les agents dont le nom commence par les caractères CI. Les agents correspondant à ce critère incluent CI, CI1 ou CI_Agent2.
Filtre de balises : spécifiez une ou plusieurs balises pour vous assurer que seuls les agents de build comportant les balises correspondantes exécuteront cette build. En général, vous appliquez des balises à certains agents de build pour les réserver à des fins spéciales. Par exemple, vous configurez un agent de build sur un ordinateur de build conçu pour traiter vos builds d'archivage contrôlé. Vous appliquez la balise de contrôle à cet agent de build. Enfin, vous appliquez la balise de contrôle à la définition de build afin qu'elle soit traitée uniquement par l'agent également référencé par cette balise. Pour spécifier des balises, vous cliquez sur le bouton de sélection (...).
Notes
Le pool des agents de build disponibles pour traiter cette build est déterminé par le contrôleur de build que vous avez spécifié pour cette définition de build. Pour modifier le contrôleur de build, cliquez sur l'onglet Valeurs par défaut des builds, ouvrez le menu Contrôleur de build, puis sélectionnez un contrôleur de build.
Opérateur de comparaison de balises : Dans le menu, cliquez l'une des valeurs suivantes :
MatchExactly : Cliquez sur cette valeur si vous souhaitez traiter cette définition de build uniquement par les agents de build dont le jeu de balises correspond exactement aux balises spécifiées dans le champ Filtre de balises. Si vous ne spécifiez pas de balise, n'importe quel agent peut traiter cette définition de build.
Conseil
En cliquant sur MatchExactly, vous limitez les agents disponibles pour cette définition de build uniquement à ceux dont le jeu de balises correspond exactement à celles spécifiées dans le champ Filtre de balises.
MatchAtLeast : Cliquez sur cette valeur si vous souhaitez que cette définition de build soit traitée par n'importe quel agent de build qui possède au moins le même jeu de balises que vous avez spécifiées dans le champ Filtre de balises. Si vous ne spécifiez pas de balise, seuls les agents qui n'ont aucune balise peuvent traiter cette définition de build.
Spécifier des limites de temps pour l'agent de build
Pour spécifier des limites de temps, développez le nœud Avancé puis le nœud Paramètres d'agent, et spécifiez les paramètres du tableau suivant.
Pour… |
Définissez ce paramètre… |
En suivant ces recommandations... |
|---|---|---|
Spécifier le temps maximum accordé à l'agent de build pour traiter la build |
Durée d'exécution maximale |
Tapez une valeur d'intervalle de temps au format hh:mm:ss. Par exemple, la build échoue avec une erreur de délai d'expiration si vous spécifiez une valeur de 04:30:15 et que l'agent de build n'a pas terminé son travail après 4 heures, 30 minutes et 15 secondes. Si vous souhaitez accorder à l'agent de build un temps illimité pour traiter la build, spécifiez une valeur de 00:00:00. |
Spécifier le temps maximum accordé pour assigner la demande de build à un agent de build |
Durée d'attente maximale |
Tapez une valeur d'intervalle de temps au format hh:mm:ss. Par exemple, la build échoue avec une erreur de délai d'expiration si vous spécifiez une valeur de 01:30:45 et que la build n'a pas été assignée à un agent de build après 1 heure, 30 minutes et 45 secondes. Si vous souhaitez accorder au contrôleur de build un temps illimité pour rechercher un agent de build pour traiter cette définition de build, spécifiez une valeur de 00:00:00. |
Exécuter des tests automatisés et activer l'analyse d'impacts des tests
Vous pouvez concevoir votre build pour l'exécution d'une ou de plusieurs séries de tests automatisés et pour l'analyse de l'impact des modifications du code sur vos tests. Pour plus d'informations, consultez Utiliser votre système de build pour exécuter des tests automatisés.
Spécifier les paramètres du processus de génération de base
Vous devez souvent modifier les paramètres du processus de génération du nœud Basic pour terminer avec succès certains scénarios les plus courants.
Pour… |
Définissez ce paramètre… |
En suivant ces recommandations... |
|---|---|---|
Personnaliser la convention utilisée pour nommer des builds terminées |
Format du numéro de build |
Votre équipe et vous-même pouvez charger des données utiles dans le nom de chaque build terminée. Pour plus d'informations, consultez Travailler avec des numéros de build. Pour personnaliser ce paramètre, vous pouvez taper du texte directement dans ce champ. Toutefois, vous pouvez facilement modifier la valeur et afficher les jetons disponibles en cliquant sur le bouton de sélection (...) pour ouvrir et utiliser la boîte de dialogue Éditeur de format du numéro de build. Dans cette boîte de dialogue, cliquez sur Macros pour afficher et insérer les jetons que vous souhaitez utiliser. |
Spécifier si et comment nettoyer l'espace de travail de l'agent de build avant qu'il ne traite la build |
Nettoyer l'espace de travail |
Dans ce menu, cliquez l'une des valeurs suivantes :
.gif "Conseil") Conseil
Si votre processus de génération ne nécessite pas le nettoyage supplémentaire que l'option Tous effectue, vous pouvez réduire considérablement la durée d'exécution de la génération si vous spécifiez Aucun (l'option la plus rapide) ou Sorties.
|
Spécifier le niveau de détail souhaité pour les commentaires du journal de génération |
Commentaires de journalisation |
Les informations de génération sont importantes pour votre équipe, mais un processus de génération qui consigne un trop gros volume d'informations peut engendrer des problèmes. Parmi ces problèmes, citons la réduction de l'espace de stockage serveur et des ressources processeur, le ralentissement des performances du serveur et la diminution de l'expérience utilisateur dans la fenêtre d'affichage des résultats de génération sur l'ordinateur client. Vous pouvez contrôler la quantité de données que vos serveurs Team Foundation doivent traiter, stocker et afficher. Pour plus d'informations, consultez Gérer des informations sur les builds et contrôler les commentaires. |
Analyser votre code afin d'identifier des erreurs courantes |
Effectuer l'analyse du code |
Dans ce menu, cliquez l'une des valeurs suivantes :
Pour plus d'informations, consultez l'une des rubriques suivantes :
|
Stocker vos symboles afin d'activer des fonctionnalités telles que le débogage d'historique |
Indexer les sources et Chemin d'accès pour publier les symboles |
Vous pouvez configurer votre définition de build de façon à publier des données de symboles afin d'activer des fonctionnalités telles que le débogage d'historique. Pour plus d'informations, consultez Publier des données symboles. |
Spécifier les paramètres avancés du processus de génération
Les paramètres de processus de génération offerts dans le nœud Avancé sont ceux que vous devez modifier pour terminer avec succès certains scénarios les moins courants.
Pour… |
Définissez ce paramètre… |
En suivant ces recommandations... |
|---|---|---|
Valider du code par rapport à des diagrammes de couche |
Arguments MSBuild |
Incluez la chaîne suivante dans cette valeur de paramètre : /p:ValidateArchitecture=true. Pour plus d'informations, consultez Comment : valider du code .NET par rapport à des diagrammes de couche. |
Spécifier des arguments de ligne de commande à passer à MS Build |
Arguments MSBuild |
Si votre processus de génération nécessite que vous passiez des arguments à MSBuild, tapez-les dans le paramètre Arguments MSBuild. Pour plus d'informations, consultez Référence de la ligne de commande MSBuild. |
Lier chaque build terminée à tous les ensembles de modifications du code, ainsi que les éléments de travail associés |
Associer des ensembles de modifications et des éléments de travail |
Dans la plupart des cas, la meilleure pratique consiste à affecter à ce paramètre la valeur True (valeur par défaut). Ceci est particulièrement vrai pour les builds planifiées, telles que les builds nocturnes, car vous utilisez souvent des builds planifiées effectuées avec succès pour confirmer des correctifs ou exécuter des tests supplémentaires. Chaque définition de build gère son propre enregistrement auquel les ensembles de modifications et éléments de travail attendent d'être associés avec la build terminée suivante. Par exemple, l'ensemble de modifications 382 est généré à la fois par la Build A et la Build B. La Build A est mise en file d'attente et terminée avec succès. La Build B est mise en file d'attente et échoue. L'ensemble de modifications 382 est à présent lié à la build terminée avec succès de la Build A et la build terminée ayant échoué de la Build B. L'ensemble de modifications 382 ne sera pas lié à la build terminée suivante de la Build A, mais à la build terminée suivante de la Build B. |
Copier dans le dossier de dépôt les fichiers exécutables et autres fichiers binaires qui résultent de la génération des projets |
Copier les sorties dans le dossier cible |
Affectez à ce paramètre la valeur True pour copier les fichiers exécutables et autres fichiers binaires qui résultent de la génération des projets dans ce dossier de dépôt. Remarque
Le dossier de dépôt est spécifié dans l'onglet Valeurs par défaut des builds.
|
Créer un élément de travail lorsque la build échoue |
Créer un élément de travail en cas d'échec |
Affectez à ce paramètre la valeur True pour que le système crée un élément de travail lorsque la build échoue. |
Générer une version spécifique de votre code source |
Obtenir la version |
Indiquez la spécification de version qui identifie la version que vous souhaitez générer. Pour plus d'informations sur les spécifications de versions, consultez Syntaxe de ligne de commande (Contrôle de version). |
Étiqueter la version de chaque fichier compilé dans chaque build terminée |
Sources d'étiquettes |
Affectez à ce paramètre la valeur True pour que le système marque chaque fichier de code source avec une étiquette. Cette action permet à votre équipe d'identifier facilement quelle version de chaque fichier est incluse dans la build terminée. |
Spécifier le nombre de bits de la version MSBuild utilisée pour traiter votre build |
Plateforme MSBuild |
Spécifiez l'une des valeurs suivantes :
|