Créer et utiliser des agents de build
Pour utiliser Team Foundation Build, votre équipe doit disposer d'au moins un agent de build. Un agent de build effectue les opérations de votre génération qui sollicitent le processeur de manière intensive, lesquelles incluent l'obtention de fichiers du contrôle de version, la configuration de l'espace de travail, la compilation de code, l'exécution de tests et la fusion de fichiers à nouveau dans le contrôle de version. Chaque agent de build est dédié à un contrôleur de build unique et est contrôlé par ce dernier.
Avant de commencer
Vous devez connaître le rôle joué par les agents de build dans un système de génération, ainsi que les différentes façons de les utiliser. Pour plus d'informations, consultez Fonctionnement d'un système Team Foundation Build.
Un agent de build est hébergé sur un ordinateur de build. Par conséquent, vous devez configurer un ordinateur de build avant de pouvoir créer et utiliser un agent de build. Chaque ordinateur de build peut héberger un ou plusieurs agents de build. Pour plus d'informations, consultez Configurer un ordinateur de build.
Dans cette rubrique
Autorisations requises
Créer un agent de build
Modifier un agent de build
Boîte de dialogue Propriétés de l'agent de build
- Informations complémentaires sur la propriété Répertoire de travail
Utilisation de votre agent de build pour l'exécution de tests
Installer des logiciels supplémentaires
Installer les logiciels requis pour compiler le code
Installer les logiciels requis pour effectuer d'autres tâches
Assigner des balises à un agent de build
Supprimer un agent de build
Autorisations requises
Pour exécuter cette procédure, vous devez être membre du groupe Administrateurs sur l'ordinateur de build, et votre autorisation Gérer les ressources de build doit avoir la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.
Créer un agent de build
Pour créer un agent de build
Ouvrez une session sur l'ordinateur de build sur lequel que vous voulez créer l'agent de build.
Cliquez sur Démarrer, sur Tous les programmes, sur Microsoft Team Foundation Server 2010 Bêta 2, puis sur Console Administration Team Foundation.
La Console Administration Team Foundation s'affiche.
Dans le volet d'arborescence, développez le nom du serveur, puis cliquez sur le nœud Team Foundation Build.
Les informations sur l'ordinateur de build s'affichent dans le volet de contenu.
Si le message Service de build configuré pour... n'apparaît pas, consultez Configurer un ordinateur de build.
Cliquez sur Nouvel agent.
La boîte de dialogue Propriétés de l'agent de build s'affiche. Pour plus d'informations, consultez Propriétés de l'agent de build plus loin dans cette rubrique.
Une fois la modification des propriétés de l'agent terminée, cliquez sur OK.
Si le lien Démarrer apparaît immédiatement sous le nom de l'agent de build, cliquez dessus.
Modifier un agent de build
Vous pouvez modifier un agent de build à partir d'un ordinateur client ou directement sur l'ordinateur de build qui héberge l'agent de build.
Pour modifier un agent de build à partir d'un ordinateur client
Dans Visual Studio, ouvrez le menu Générer, puis cliquez sur Gérer les contrôleurs de build.
La boîte de dialogue Gérer les contrôleurs de build apparaît.
Cliquez sur l'agent de build à modifier, puis sur Propriétés.
La boîte de dialogue Propriétés de l'agent de build s'affiche.
Pour modifier un agent de build sur l'ordinateur de build
Ouvrez une session sur l'ordinateur de build qui exécute l'agent de build que vous souhaitez modifier.
Cliquez sur Démarrer, sur Tous les programmes, sur Microsoft Team Foundation Server 2010 Bêta 2, puis sur Console Administration Team Foundation.
La Console Administration Team Foundation s'affiche.
Dans le volet d'arborescence, développez le nom du serveur, puis cliquez sur le nœud Team Foundation Build.
Immédiatement sous le nom de l'agent de build à modifier, cliquez sur Propriétés.
La boîte de dialogue Propriétés de l'agent de build s'affiche.
Boîte de dialogue Propriétés de l'agent de build
Dans la boîte de dialogue Propriétés de l'agent de build, vous pouvez afficher ou modifier le nom complet et la description, en plus d'autres propriétés qui affectent la façon dont l'agent de build fonctionne.
Nom complet, Description
Fournissez un nom et une description qui peuvent aider les membres de l'équipe à identifier et obtenir facilement des informations importantes relatives à l'agent de build.
Contrôleur
Spécifiez le contrôleur de build que vous voulez utiliser pour contrôler cet agent de build. Le contrôleur de build peut s'exécuter sur le même ordinateur de build que cet agent de build ou sur un ordinateur de build différent.
Nom de l'ordinateur
Cette zone affiche le nom de l'ordinateur de build qui héberge cet agent de build.
Répertoire de travail
Utilisez cette zone pour spécifier le chemin d'accès au répertoire de travail. Pour plus d'informations, consultez Informations complémentaires sur la propriété Répertoire de travail.
Le service Agent de build est activé
Activez cette case à cocher pour permettre à cet agent de build de fonctionner, ou désactivez-la si vous voulez le désactiver et empêcher que des builds lui soient assignées.
Conseil
Il est conseillé de désactiver un agent de build chaque fois que vous effectuez des tâches de maintenance sur l'ordinateur de build.
Informations complémentaires sur la propriété Répertoire de travail
L'agent de build utilise le répertoire de travail pour les opérations où l'agent doit lire ou écrire dans des fichiers. Par exemple, les fichiers sources sont copiés vers des sous-répertoires de ce dossier, et les fichiers binaires sont créés et stockés dans d'autres sous-répertoires de ce dossier.
Jetons de répertoire de travail
Bien que vous puissiez spécifier un chemin d'accès littéral pour la propriété Répertoire de travail (par exemple, c:\temp\build\), l'utilisation de jetons pour spécifier le chemin d'accès constitue une approche plus flexible. Vous pouvez utiliser deux genres de jetons :
Variables d'environnement : les variables d'environnement contiennent des informations relatives à l'environnement pour le système et l'utilisateur qui est connecté.
Supposons que vous ayez configuré le service Team Foundation Build pour qu'il s'exécute sous un compte appelé BuildSvcAcct. Vous spécifiez $(HomeDrive)\Builds comme répertoire de travail pour un agent de build sur un ordinateur de build qui exécute Windows Server 2008. Par conséquent, l'agent de build utilise généralement comme répertoire de travail un répertoire physique, dont l'emplacement se rapproche de l'emplacement suivant : C:\Builds.
Conseil
Pour répertorier les variables d'environnement sur votre ordinateur de build, ouvrez une invite de commandes, puis tapez set.
Variables Team Foundation Build : vous pouvez utiliser les variables suivantes dans un répertoire de travail d'agent de build :
$(BuildAgentId) : entier généré automatiquement qui identifie de façon unique un agent de build dans une collection de projets d'équipe.
$(BuildAgentName) : nom complet de l'agent de build.
$(BuildDefinitionId) : entier généré automatiquement qui identifie de façon unique une définition de build dans une collection de projets d'équipe.
$(BuildDefinitionPath) : nom de projet d'équipe et nom de définition de build, séparés par une barre oblique inverse.
Exemple de répertoire de travail
Supposons que vous ayez un agent de build nommé BuildBot3. Vous avez défini deux builds nommées NightlyBuild et WeeklyBuild dans un projet d'équipe nommé CoolApp. Dans la zone Répertoire de travail, vous spécifiez la valeur suivante : $(SystemDrive)\TeamBuilds\$(BuildAgentName)\$(BuildDefinitionPath). En conséquence, l'agent de build BuildBot3 crée et utilise les deux répertoires de travail suivants :
C:\TeamBuilds\BuildBot3\CoolApp\NightlyBuild
C:\ TeamBuilds\BuildBot3\CoolApp\WeeklyBuild
S'assurer que le répertoire de travail n'est pas trop long
Le répertoire de travail que vous spécifiez ne doit pas entraîner la production, par l'agent de build, de chemins d'accès physiques d'une longueur supérieure à 259 caractères. Sinon, vos builds échouent et enregistrent cette erreur : TF10128 : le chemin d'accèsPhysicalPath contient plus de 259 caractères. Tapez ou sélectionnez un chemin d'accès plus court. Cette erreur peut vous surprendre, car vous ne pouvez normalement pas remarquer les chemins d'accès physiques créés par l'agent de build.
Pour résoudre ce problème, vous pouvez spécifier un répertoire de travail qui produit un chemin d'accès physique plus court. Par exemple, vous pourriez spécifier le répertoire $(HOMEDRIVE)\bld\$(BuildAgentID)\$(BuildDefinitionID), ce qui produirait un répertoire de travail se rapprochant du chemin d'accès suivant : c:\bld\3\2\.
Sous-répertoires créés dans le répertoire de travail
L'agent de build crée et utilise les sous-répertoires suivants sous le chemin d'accès spécifié.
Sous-répertoire |
Utilisé pour stocker les fichiers… |
|---|---|
Sources |
Lus par l'agent de build, tels que les fichiers sources. Vous pouvez spécifier les fichiers à télécharger à l'aide des paramètres Espace de travail pour chaque définition de build. Pour plus d'informations, consultez Travailler avec des espaces de travail de build. |
Binaries |
Compilés par l'agent de build, tels que les fichiers d'application compilés. |
TestResults |
Produits par les tests que l'agent de build a exécutés. |
Utilisation de votre agent de build pour l'exécution de tests
Vous pouvez concevoir un processus de génération qui exécute une ou plusieurs séries de tests automatisés. Comme l'indique le tableau suivant, certains tests et opérations de tests requièrent un agent de build répondant à des exigences particulières.
Type de test |
Visual Studio 2010 doit être installé sur l'ordinateur de build |
Autres spécifications et informations |
|---|---|---|
Couverture du code |
Oui |
Aucun |
Tests codés de l'interface utilisateur |
Oui |
L'ordinateur de build doit s'exécuter en tant que processus interactif. Pour plus d'informations sur la configuration de ce genre d'ordinateur de build, consultez Configurer un ordinateur de build. Pour plus d'informations sur ces types de tests, consultez Test de l'interface utilisateur avec des tests d'interface utilisateur automatisés. |
Génération de données de test de base de données |
Non |
Aucun |
Tests unitaires de base de données |
Oui |
Aucun |
Tests génériques |
Non |
Aucun Pour plus d'informations, consultez Création d'un test automatisé qui lance un exécutable au moyen de tests génériques. |
Tests de charge |
Oui |
Aucun Pour plus d'informations, consultez Configuration de l'ordre de votre série de tests à l'aide de tests ordonnés. |
Tests unitaires MSTest |
Non |
Aucun |
Tests ordonnés |
Non |
Aucun |
Analyse d'impact des tests |
Non |
Aucun |
Tests Web |
Oui |
Aucun |
Pour plus d'informations sur le processus de build exécutant des tests, consultez Utiliser votre système de build pour exécuter des tests automatisés.
Installer des logiciels supplémentaires
Pour que votre agent de build effectue certaines tâches, vous devrez peut-être installer des logiciels supplémentaires sur l'ordinateur de build.
Installer les logiciels requis pour compiler le code
Pour qu'un agent génère un grand nombre des builds des projets les plus classiques, aucun logiciel supplémentaire n'est requis. Par exemple, un agent de build peut compiler une application WPF Visual C# de base sans qu'aucun logiciel supplémentaire ne soit installé.
Toutefois, vous devez installer des logiciels supplémentaires pour compiler d'autres types de projets. Par exemple, vous devez installer Visual Studio pour compiler un projet d'installation.
Pour garantir que l'agent de build peut compiler vos projets
Installez la version et l'édition de Visual Studio que votre équipe utilise sur l'ordinateur de build où s'exécute l'agent de build.
Installez tous les autres logiciels et composants qui sont installés dans votre environnement de développeur et qui sont requis pour générer votre application.
Installer les logiciels requis pour effectuer d'autres tâches
Pour qu'un agent de build effectue diverses autres tâches, il peut être nécessaire d'installer des logiciels supplémentaires sur l'ordinateur de build. Le tableau suivant identifie certaines tâches courantes d'agent de build et les logiciels requis pour effectuer ces tâches.
Pour que l'agent de build… |
Les logiciels suivants doivent être installés sur l'ordinateur de l'agent de build… |
|---|---|
Générer des projets d'application Web ASP.NET |
Visual Studio 2010 |
Générer des projets C++ |
Visual Studio 2010 |
Assigner des balises à un agent de build
À mesure que votre système de génération monte en charge, vous devrez probablement définir des agents de build spécialisés. Chaque fois qu'un agent de build a des fonctions spéciales ou est destiné à un genre d'utilisation spécifique, vous devez assigner une ou plusieurs balises à cet agent. Ainsi, lorsqu'un membre de l'équipe crée une définition de build qui requiert un certain genre d'agent de build, il peut spécifier la balise dans sa définition de build.
Vous pouvez appliquer plusieurs balises à un agent de build. Par exemple, vous pourriez créer un agent de build avec les balises x86 et Release pour indiquer un agent configuré pour compiler la configuration Release d'une application 32 bits.
Si vous exécutez plusieurs agents de build sur le même ordinateur de build, ils auront probablement tous les mêmes fonctions. Par conséquent, vous voudrez probablement appliquer les mêmes balises à tous les agents de build sur cet ordinateur de build.
Utiliser des balises pour représenter les fonctions d'agent de build
Le tableau suivant offre des exemples de noms de balises et les fonctions d'agent de build qu'ils pourraient représenter.
Vous pourriez appliquer les balises suivantes à l'agent de build… |
Pour identifier un agent de build qui peut… |
|---|---|
x86 |
Compiler des applications 32 bits |
x64 |
Compiler des applications 64 bits |
IIS |
Compiler une application Web ASP.NET, puis l'organiser et l'héberger sur l'ordinateur de build sur lequel l'agent de build s'exécute |
test, stress |
Un agent de build qui s'exécute sur un ordinateur de build sur lequel Test Professional 2010 a été configuré pour l'exécution de tests de charge et de contrainte. |
Utiliser des balises pour équilibrer la charge de votre processus de génération
Vous pouvez utiliser des balises pour équilibrer la charge du travail de traitement de la génération que votre équipe doit effectuer. Par exemple, vous pouvez avoir une définition de build appelée Build d'archivage qui valide vos archivages. (Pour plus d'informations, consultez Définir une build d'archivage contrôlé pour la validation des modifications). Cette définition de build, dont une seule instance peut être exécutée à la fois, est souvent exécutée. Par conséquent, vous configurez un ordinateur de build qui dispose de matériel hautement performant (tel qu'un processeur multicœur et un lecteur de disque dur rapide). Vous créez ensuite un agent de build sur cet ordinateur et lui assignez l'archivage des balises. Vous configurez la définition de build pour qu'elle s'exécute uniquement sur un agent de build qui a la balise d'archivage.
Vous avez une autre définition de build appelée Build de suivi rapide, que vous utilisez pour traiter les builds d'un projet de priorité élevée sur lequel une équipe travaille. Vous configurez un autre agent de build qui répond aux spécifications de ce projet spécial. Vous lui assignez la balise FastTrack, puis vous configurez la définition de build pour qu'elle s'exécute uniquement sur un agent de build qui a cette balise.
Pour appliquer une balise à un agent de build sur un ordinateur client
Dans le menu Générer, cliquez sur Gérer les contrôleurs de build.
La boîte de dialogue Gérer les contrôleurs de build apparaît.
Cliquez sur l'agent de build auquel vous voulez appliquer une balise, puis sur Propriétés.
La boîte de dialogue Propriétés de l'agent de build s'affiche.
Utilisez l'une des méthodes suivantes pour appliquer une ou plusieurs balises :
Sélectionnez une ou plusieurs balises dans la liste.
Cliquez sur le lien Ajouter une nouvelle balise. Dans la boîte de dialogue Ajouter une nouvelle balise, tapez le nom de la balise que vous voulez appliquer.
Pour appliquer une balise à un agent de build sur l'ordinateur de build
Ouvrez une session sur l'ordinateur de build qui exécute l'agent de build que vous souhaitez modifier.
Cliquez sur Démarrer, sur Tous les programmes, sur Microsoft Team Foundation Server 2010 Bêta 2, puis sur Console Administration Team Foundation.
La Console Administration Team Foundation s'affiche.
Dans le volet d'arborescence, développez le nom du serveur, puis cliquez sur le nœud Team Foundation Build.
Immédiatement sous le nom de l'agent de build, cliquez sur Propriétés.
La boîte de dialogue Propriétés de l'agent de build s'affiche.
Utilisez l'une des méthodes suivantes pour appliquer une ou plusieurs balises :
Sélectionnez une ou plusieurs balises dans la liste.
Cliquez sur le lien Ajouter une nouvelle balise. Dans la boîte de dialogue Ajouter une nouvelle balise, tapez le nom de la balise que vous voulez appliquer.
Supprimer un agent de build
Vous pouvez supprimer un agent de build à l'aide d'un ordinateur client ou directement à partir de l'ordinateur de build qui héberge l'agent de build.
Remarque La suppression de l'agent de build ne désinstalle pas le service Team Foundation Build de l'ordinateur de build.
Pour supprimer un agent de build à l'aide d'un ordinateur client
Dans le menu Générer, cliquez sur Gérer les contrôleurs de build.
La boîte de dialogue Gérer les contrôleurs de build apparaît.
Cliquez sur le contrôleur de build ou l'agent de build que vous voulez supprimer, puis sur Supprimer.
Pour supprimer un agent de build de son ordinateur de build
Ouvrez une session sur l'ordinateur de build qui exécute l'agent de build que vous souhaitez modifier.
Cliquez sur Démarrer, sur Tous les programmes, sur Microsoft Team Foundation Server 2010 Bêta 2, puis sur Console Administration Team Foundation.
La Console Administration Team Foundation s'affiche.
Dans le volet d'arborescence, développez le nom du serveur, puis cliquez sur le nœud Team Foundation Build.
Juste sous le nom de l'agent de build, cliquez sur Supprimer.
Voir aussi
Autres ressources
Définir votre processus de build
Historique des modifications
Date |
Historique |
Motif |
|---|---|---|
|
Mai 2011 |
Ajout d'informations sur la façon d'exécuter des tests. |
Améliorations apportées aux informations. |