Déployer et configurer un contrôleur de build

Pour utiliser Team Foundation Build, votre équipe doit avoir au moins un contrôleur de build pour effectuer des tâches légères et distribuer les opérations de votre processus de génération qui sollicitent le processeur de manière intensive à son pool d'agents de build.

Conseil
Si votre collection de projets d'équipe est hébergée sur le service Team Foundation, vous devriez pouvoir utiliser le Contrôleur de build hébergé au lieu de déployer votre propre système de build.

Chaque contrôleur de build est dédié à une seule collection de projets d'équipe.Le contrôleur de build effectue des tâches légères tel que la détermination du nom de la build, la création de l'étiquette dans le contrôle de version, l'enregistrement des remarques et le signalement de l'état de la build.Le contrôleur de build utilise l'activité AgentScope pour déléguer les opérations qui sollicitent le processeur de manière intensive, telles que la compilation de code ou l'exécution de tests, aux agents de build présents dans son pool.Ces agents de build peuvent être hébergés sur le même serveur de builds, ou sur un serveur de builds différent.

Étant donné qu'un contrôleur de build ne requiert généralement pas de portion significative de temps processeur, vous pouvez, dans de nombreux cas, l'héberger sur le même ordinateur que votre serveur Team Foundation Server, comme indiqué ci-dessus, ou sur un ordinateur physique ou virtuel de faible puissance.

Toutefois, un contrôleur de build peut nécessiter une quantité de mémoire significative dans certaines situations. Vous devez donc fournir la quantité de mémoire nécessaire pour garantir le fonctionnement correct.Ou, selon les besoins et les ressources de votre équipe, vous pouvez exécuter le contrôleur de build sur un autre ordinateur que votre serveur Team Foundation Server.

Autorisations requises

Vous devez être membre du groupe Administrateurs Windows sur le serveur de builds et membre du groupe Project Collection Build Administrators sur votre collection de projets d'équipe.Consultez Autorisations de Team Foundation Server.

Que voulez-vous faire ?

• Créer ou modifier un contrôleur de build

• Permettez à vos processus de génération de tirer parti des fichiers binaires supplémentaires

• Spécifier le nombre maximal de builds exécutées simultanément

• Supprimer un contrôleur de build

• Utilisez le contrôleur de build hébergé dans une collection de projets d'équipe hébergée sur le service Team Foundation.

Créer ou modifier un contrôleur de build

Pour créer ou modifier un contrôleur de build à partir du serveur de builds

1. Ouvrez une session sur le serveur de build.

2. À partir du menu Démarrer de Windows, exécutez la Console Administration Team Foundation.

3. Dans le volet d'arborescence de la console Administration Team Foundation Server, développez le nom du serveur, puis sélectionnez le nœud Configuration de build.

   [!REMARQUE]

   Si le message Configurer les fonctionnalités installées s'affiche, consultez Déployer un serveur de builds.

4. Sur la page Configuration de build :

   • Si un contrôleur n'est pas répertorié, choisissez Nouveau Contrôleur.

   • Si un contrôleur est déjà répertorié :

     

     Choisissez Propriétés.

   La boîte de dialogue Propriétés du contrôleur de build s'affiche.

Pour modifier un contrôleur de build dans Visual Studio

1. Dans Visual Studio, dans Team Explorer :

   1. Si vous n'êtes pas déjà connecté à un projet d'équipe dans la collection de projets d'équipe, connectez-vous au projet d'équipe.

   2. Sélectionnez Home, puis Builds.

2. Sur la page Builds, choisissez Actions, puis Gérer les contrôleurs de build.

   La boîte de dialogue Gérer les contrôleurs de build apparaît.

   

3. Sélectionnez le contrôleur de build à modifier, puis sélectionnez Propriétés.

   La boîte de dialogue Propriétés du contrôleur de build s'affiche.

Dans les champs Nom complet et Description : tapez un nom et une description qui peuvent aider les membres de l'équipe à identifier facilement le contrôleur de build approprié lorsqu'ils définissent leurs processus de génération.

Consultez les sections ci-dessous pour obtenir plus d'informations sur la configuration de votre contrôleur de build.

Permettez à vos processus de génération de tirer parti des fichiers binaires supplémentaires

Vous pouvez personnaliser votre processus de génération de manière plus approfondie en exploitant :

• Assemblys qui contiennent vos activités de flux de travail personnalisées

• Tâches MSBuild personnalisées

• Infrastructures de tests unitaires tiers dans votre séries de tests.

Pour permettre à vos processus de génération d'exploiter ces types de code, vérifiez les binaires dans le dossier (ni dans l'un de ses dossiers descendants) que vous spécifiez dans la zone Chemin d'accès du contrôle de version vers les assemblys personnalisés.Lorsque vous définissez ou modifiez la valeur dans cette zone, le serveur de builds redémarre automatiquement pour charger les assemblys.

Conseil
Si vos résultats de build incluent un message d'erreur TF215097, votre processus de génération peut inclure une activité personnalisée qui n'est pas dans ce dossier ni dans l'un de ses dossiers descendants.

Pour obtenir des instructions sur la façon d'archiver les fichiers binaires dans le contrôle de version, consultez Utilisation de fichiers binaires tiers non générés par votre code.

Spécifier le nombre maximal de builds exécutées simultanément

Dans la plupart des cas, vous devez laisser Utiliser par défaut le nombre d'agents activés défini pour cette valeur.Toutefois, dans certains cas, vous pouvez souhaiter vérifier la profondeur de la file d'attente de builds.Par exemple :

• Vous constatez qu'un trop grand nombre de builds ont l'état En cours d'exécution même si un grand nombre d'entre elles sont bloquées car elles attendent qu'un agent de build leur soit assigné.Cette situation peut désorienter l'équipe.Pour éviter ce problème, sélectionnez Indiquez le maximum, puis spécifiez une valeur qui est inférieure au nombre des agents de build regroupés sous le contrôleur de build.

• Vous concevez un modèle de build personnalisé pour permettre à vos builds d'exploiter plusieurs agents de build à la fois, d'un pool de 12 agents de build sous le contrôleur de build.Les builds traitées par ce contrôleur de build sont basées sur un modèle de build personnalisé qui délègue simultanément à trois agents de build.Pour rendre les données de la file d'attente de build plus utiles, vous pouvez configurer le contrôleur de build avec Nombre maximal de builds exécutées simultanément défini avec Indiquez le maximum ayant la valeur 4.

Supprimer un contrôleur de build

1. Dans Visual Studio, ouvrez la boîte de dialogue Gérer les contrôleurs de build, comme indiqué ci-dessus dans Modifier un contrôleur de build à partir de Visual Studio.

2. Sélectionnez et supprimez ensuite chaque agent de build sous le contrôleur de build, en choisissant Supprimer ou Propriétés, puis en utilisant la boîte de dialogue Propriétés de l'agent de build pour assigner l'agent de build à un autre contrôleur de build.

3. Sélectionnez le contrôleur de build que vous voulez supprimer, puis Supprimer.

[!REMARQUE]

Vous pouvez également utiliser la console Administration Team Foundation pour supprimer le contrôleur de build pendant que vous êtes connecté au serveur de builds.Mais dans ce cas, vous devrez peut-être encore utiliser Visual Studio ou ouvrir une session sur d'autres serveurs de builds dans un premier temps, pour supprimer tous les agents de build distants regroupés par le contrôleur de build.

Utilisez le contrôleur de build hébergé dans une collection de projets d'équipe hébergée sur le service Team Foundation.

Si votre collection de projets d'équipe est hébergée sur le service Team Foundation, vous devriez pouvoir ignorer le déploiement de votre propre contrôleur de build et utiliser le contrôleur de build hébergé à la place.Pour utiliser le contrôleur de build hébergé, sélectionnez-le simplement lorsque vous définissez votre processus de génération.

Le contrôleur de build hébergé fournit un seul agent de build temporaire standard.

Pour plus d'informations sur les capacités du contrôleur de build hébergé, consultez Utiliser le contrôleur de build hébergé.

Étapes suivantes

• Déployez et configurez les agents de build
  Utilisez un agent de build pour effectuer les opérations de votre génération qui sollicitent le processeur de manière intensive.Il s'agit notamment d'obtenir des fichiers du contrôle de version, de configurer l'espace de travail, de compiler du code et d'exécuter des tests.Vous pouvez héberger un ou plusieurs agents de build sur un serveur de build.

• Configurer des dossiers cible
  Vous pouvez préparer et indiquer ensuite un ou plusieurs dossiers de dépôt afin que votre système de génération puisse fournir des fichiers binaires, des résultats de tests et des fichiers journaux à votre équipe.

• Montez en charge votre système Team Foundation Build
  À mesure que votre équipe et que votre base de code se développent, vous pouvez développer de façon incrémentielle votre système de génération assez facilement.

• Gérer votre système de génération
  Après avoir déployé votre serveur de builds, vous pouvez le gérer à partir de la Console Administration Team Foundation.Vous pouvez gérer le contrôleur de build et les agents de build à partir de la console Administration Team Foundation ou à partir de Visual Studio.

• Définir votre processus de génération
  Une fois que votre système de génération est en place, vous pouvez définir votre processus de génération, qui contient vos instructions sur les projets de code à compiler, les actions qui déclenchent une génération, les tests à exécuter et toutes les autres procédures requises par votre équipe.