Partager via


Créer et utiliser un contrôleur de build

Pour utiliser Team Foundation Build, votre équipe doit avoir au moins un contrôleur de build, qui regroupe et gère les services d'un ou de plusieurs agents de build. Il effectue certaines tâches, mais il distribue 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. Chaque contrôleur de build est dédié à une seule collection de projets d'équipe.

Avant de commencer :

  • Vous devez lire des informations relatives au rôle joué par les contrôleurs 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 contrôleur 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 contrôleur de build. Chaque ordinateur de build peut héberger un seul contrôleur de build. Pour plus d'informations, consultez Configurer un ordinateur de build.

Dans cette rubrique

  • Autorisations requises

  • Créer un contrôleur de build

  • Modifier un contrôleur de build

  • Boîte de dialogue Propriétés du contrôleur de build

  • Supprimer un contrôleur 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 dans Visual Studio Team Foundation Server doit avoir la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Créer un contrôleur de build

Pour créer un contrôleur de build

  1. Ouvrez une session sur l'ordinateur de build sur lequel que vous voulez créer le contrôleur de build.

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

  3. Dans le volet d'arborescence, développez le nom du serveur.

  4. Cliquez sur le nœud Configuration de build.

    Les informations sur l'ordinateur de build s'affichent dans le volet de contenu.

    Si le message Service de build configuré pour... ou Service de build non inscrit apparaît, consultez Configurer un ordinateur de build.

  5. Si le lien Nouveau contrôleur s'affiche dans le volet de contenu, cliquez sur ce lien.

  6. (Facultatif) Immédiatement sous le nom du contrôleur de build, cliquez sur Propriétés pour modifier différentes propriétés du contrôleur de build.

    La boîte de dialogue Propriétés du contrôleur de build s'affiche. Pour plus d'informations, consultez Propriétés du contrôleur de build plus loin dans cette rubrique.

  7. Si le lien Démarrer apparaît immédiatement sous le nom du contrôleur de build, cliquez sur ce lien.

Modifier un contrôleur de build

Vous pouvez modifier un contrôleur de build à partir d'un ordinateur client ou directement sur l'ordinateur de build qui héberge le contrôleur de build.

Pour modifier un contrôleur de build à partir d'un ordinateur client

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

  2. Sélectionnez le contrôleur de build à modifier, puis cliquez sur 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 sur l'ordinateur de build

  1. Ouvrez une session sur l'ordinateur de build qui exécute le contrôleur de build que vous souhaitez modifier.

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

  3. Dans le volet d'arborescence, développez le nom du serveur.

  4. Cliquez sur le nœud Team Foundation Build.

  5. Immédiatement sous le nom du contrôleur de build à modifier, cliquez sur Propriétés.

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

Boîte de dialogue Propriétés du contrôleur de build

Dans la boîte de dialogue Propriétés du contrôleur 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 le contrôleur de build fonctionne.

Nom complet, Description

Fournissez un nom et une description qui peuvent aider les personnes à identifier et obtenir facilement des informations importantes relatives au contrôleur de build. Par exemple, ces valeurs peuvent aider des membres de votre équipe à spécifier le contrôleur de build approprié lorsqu'ils définissent une build.

Nom de l'ordinateur

Cette zone affiche le nom de l'ordinateur de build qui héberge ce contrôleur de build.

Chemin d'accès du contrôle de version vers les assemblys personnalisés

Vous pouvez utiliser ce champ pour permettre à vos builds de tirer parti des genres d'assemblys suivants :

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

  • Tâches MSBuild personnalisées

Vous pouvez vérifier ce genre de code dans tout dossier qui est un descendant du dossier spécifié dans ce champ.

Notes

Si vous définissez ou modifiez cette valeur, le service Team Foundation Build redémarre automatiquement pour charger les nouveaux assemblys.

Nombre maximal de builds exécutées simultanément

Vous pouvez utiliser ce champ pour contrôler la profondeur de la file d'attente de build. Dans la plupart des cas, vous devez laisser Utiliser par défaut le nombre d'agents défini pour cette valeur.

Dans certains cas, vous trouverez peut-être 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é. Ce genre de situation peut être ambigu pour une équipe. Dans ce cas, vous pouvez souhaiter cliquer sur Indiquez le maximum, puis spécifier une valeur qui est inférieure au nombre des agents de build regroupés sous le contrôleur de build.

Par exemple, vous pouvez concevoir un modèle de build personnalisé pour permettre à vos builds de tirer parti de plusieurs agents de build à la fois. 12 agents de build sont regroupés sous votre contrôleur de build. Les builds traitées par ce contrôleur de build sont basées sur un modèle de build personnalisée qui utilise simultanément trois agents de build pour traiter la build. Pour donner à la file d'attente de build une apparence plus exacte, vous pourriez 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.

Le service de contrôleur de build est activé

Activez cette case à cocher pour permettre à ce contrôleur 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

Vous pouvez éviter certains problèmes en désactivant un contrôleur de build chaque fois que vous exécutez la maintenance sur l'ordinateur de build.

Supprimer un contrôleur de build

Vous pouvez supprimer un contrôleur de build à l'aide d'un ordinateur client ou directement à partir de l'ordinateur de build qui héberge le contrôleur de build.

Remarque   La suppression du contrôleur de build ne désinstalle pas le service Team Foundation Build de l'ordinateur de build.

Pour supprimer un contrôleur de build à l'aide d'un ordinateur client

  1. Dans Visual Studio, 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.

  2. Cliquez sur le contrôleur de build que vous voulez supprimer, puis sur Supprimer.

Pour supprimer un contrôleur de build de son ordinateur de build

  1. Ouvrez une session sur l'ordinateur de build qui exécute le contrôleur de build que vous souhaitez modifier.

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

  3. Dans le volet d'arborescence, développez le nom du serveur.

  4. Cliquez sur le nœud Team Foundation Build.

  5. Immédiatement sous le nom du contrôleur de build que vous voulez supprimer, cliquez sur Supprimer.

Voir aussi

Autres ressources

Définir votre processus de build