Définir une build à l'aide du modèle de mise à niveau

Article
08/10/2011

Vous pouvez utiliser le modèle de mise à niveau pour continuer à utiliser des définitions de build héritées dans Visual Studio Team Foundation Server 2010. Plus précisément, vous pouvez utiliser ce modèle pour exécuter les genres suivants d'objets de build :

Définitions de build créées à l'aide de Visual Studio Team System 2008 Team Foundation Server.
Types de build créés à l'aide de Visual Studio 2005 Team Foundation Server.

Lorsque vous passez à Team Foundation Server 2010, le système crée automatiquement une définition de build Modèle de mise à niveau pour chaque définition de build héritée et chaque type de build de votre système.

En outre, lorsque vous utilisez une version antérieure de Visual Studio ALM pour créer une définition de build ou un type de build sur un serveur qui exécute Team Foundation Server 2010, le système crée automatiquement une définition de build Modèle de mise à niveau.

Pour modifier la plupart des aspects de ces objets de build hérités, vous devez modifier le fichier TFSBuild.proj. Pour plus d'informations, consultez Cibles, tâches et propriétés de Team Foundation Build. Mais vous pouvez modifier certains paramètres de l'objet de définition de build en ouvrant le nœud Builds dans Team Explorer. Ces paramètres sont expliqués dans cette rubrique.

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 modifier une définition de build Modèle de mise à niveau

Dans Team Explorer, développez le projet d'équipe dans lequel vous souhaitez définir votre build, puis développez le nœud Builds.
Cliquez avec le bouton droit sur la définition de build à modifier, puis cliquez sur Modifier la définition de build.
Sur l'onglet Valeurs par défaut des builds, ouvrez le menu Contrôleur de build, puis sélectionnez un contrôleur de build.
Cliquez sur l'onglet Processus.
Assurez-vous que Modèle de mise à niveau apparaît sous Modèle de processus de génération.
Développez le nœud Requis.
Dans Chemin d'accès du dossier de configuration, assurez-vous que le chemin d'accès au dossier qui contient votre fichier TFSBuild.proj est correctement spécifié.
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 de l'onglet Processus, selon vos besoins, modifiez 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 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 de mise à niveau
Spécifier les commentaires du journal
Spécifier les agents de build qui traitent votre build
Spécifier des limites de temps pour l'agent de build
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 de mise à niveau

Cette rubrique explique comment modifier une build à l'aide des paramètres du processus de génération pour les builds basées sur le modèle de mise à niveau. Ces informations correspondent à Visual Studio Application Lifecycle Management (ALM) tant que les conditions suivantes sont remplies :

Vous travaillez dans un projet d'équipe créé à partir de l'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 de mise à niveau.

Spécifier les commentaires du journal

Pour spécifier les commentaires du journal qui s'affiche dans la fenêtre Résultats de la génération, développez le nœud Basic, puis sélectionnez une valeur dans la liste Commentaires d'enregistrement. Le tableau suivant répertorie les valeurs des commentaires de journalisation et les effets correspondants.

Valeur	Erreurs de build	Avertissements de build	Messages Build Messages	Messages de build Messages	Messages de build Messages	Propriétés d'activité de workflow (entrées et sorties)
Minimal	Y	N	N	N	N	N
Normal	Y	Y	Y	N	N	N
Détaillé	Y	Y	Y	Y	N	N
Diagnostic	Y	Y	Y	Y	Y	Y

La valeur de commentaires de journalisation que vous spécifiez affecte également les commentaires des messages qui viennent de MSBuild. Pour plus d'informations, consultez Référence de la ligne de commande MSBuild.

Pour plus d'informations sur les rapports de build, consultez Afficher la fenêtre Résultats de la génération.

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 remplissez l'une ou l'autre des zones suivantes :

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 cette build est exécutée uniquement par les agents de build comportant les balises correspondantes. 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, 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 dans ce menu.

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 suivants.

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.

Spécifier les paramètres avancés du processus de génération

Pour terminer avec succès certains des scénarios les moins courants, vous devez modifier les paramètres du processus de génération dans le nœud Avancé.

Pour…	Définissez ce paramètre…	En suivant ces recommandations...
Spécifier le sous-répertoire dans lequel les fichiers binaires se trouvent une fois qu'ils ont été générés	Sous-répertoire Binaries	Si vous ne spécifiez pas de sous-répertoire, le système utilise un sous-répertoire intitulé Binaries.
Utiliser la définition de type de build qui existe sur l'ordinateur local	Ne pas télécharger le type de build	Affectez à cet indicateur la valeur True pour utiliser la définition de type de build de l'ordinateur local au lieu de télécharger la définition à partir de Team Foundation Server. Le chemin local utilisé est l'espace de travail local du type de build. Ce paramètre a généralement la valeur True de façon temporaire afin que vous puissiez déboguer un fichier TFSBuild.proj.
Générer des fichiers journaux d'erreurs et d'avertissements pour des projets individuels	Fichier journal par projet	Affectez True à cette valeur afin de générer des fichiers journaux d'erreurs et d'avertissements pour des projets individuels plutôt que pour des combinaisons de plateformes et configurations individuelles.
Spécifier des arguments de ligne de commande à passer à MSBuild	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.
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 : Spécifiez Auto pour exécuter MSBuild au même nombre de bits UC que le service Team Foundation Build installé sur l'agent de build. Spécifiez X86 pour toujours traiter cette build à l'aide de la version 32 bits de MSBuild. Dans la mesure où Visual Studio 2010 s'exécute comme une application 32 bits, vous pouvez rencontrer des problèmes lorsque votre build est traitée par un agent de build qui exécute la version 64 bits de service Team Foundation Build. En spécifiant X86, vous pouvez résoudre ce genre de problème. Spécifiez X64 pour toujours traiter cette build à l'aide de la version 64 bits de MSBuild. Remarque Si vous spécifiez cette valeur, vous devez vous assurer (par exemple, en utilisant une balise comme expliqué précédemment dans cette rubrique) que votre build est traitée par un agent de build hébergé par un ordinateur de build 64 bits.Sinon, votre build échoue.
Demander à MSBuild d'obtenir et d'utiliser de manière récursive des fichiers figurant dans votre Chemin d'accès du dossier de configuration	Type de récurrence	Spécifiez l'une des valeurs suivantes : Un niveau si le dossier spécifié dans Chemin d'accès du dossier de configuration contient les fichiers que MSBuild doit traiter. Complet si le dossier spécifié dans Chemin d'accès du dossier de configuration ou dans les sous-répertoires de ce dossier contient des fichiers que MSBuild doit traiter.
Spécifier le sous-répertoire utilisé pour mapper l'espace de travail et la build	Sous-répertoires Sources	Affectez à cette valeur le sous-répertoire Sources approprié relatif aux agents de build qui utilisent cet ordinateur de build. Si vous ne spécifiez pas de sous-répertoire, le système utilise un sous-répertoire intitulé Sources.
Spécifier le sous-répertoire utilisé pour stocker les résultats des tests	Sous-répertoire des résultats des tests	Affectez à cette valeur le sous-répertoire de résultats de tests approprié relatif aux agents de build qui utilisent cet ordinateur de build. Si vous ne spécifiez pas de sous-répertoire, le système utilise un sous-répertoire intitulé TestResults.

Share via