Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Nous recommandons d’utiliser Visual Studio 2017

Gérer votre système de génération

Vous avez configuré votre serveur de builds, y compris vos contrôleurs de build et agents de build. Vous avez défini vos processus de génération pour répondre aux besoins de votre équipe. Votre équipe exécute et gère maintenant vos générations automatisées pour compiler et tester votre application.

Parfois, vous vous trouverez dans des situations dans lesquelles vous devrez surveiller et gérer votre système de génération, par exemple lorsque vous diagnostiquez des problèmes ou mettez à l'échelle votre système de génération.

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 Référence des autorisations pour Team Foundation Server.

Que voulez-vous faire ?

Vous souhaitez parfois vérifier l'état et gérer vos contrôleurs de build et les agents de build, par exemple, lorsqu'un processus de génération mis en file d'attente ne démarre pas ou ne progresse pas. Vous pouvez effectuer tout cela directement à partir de Visual Studio.

Boîte de dialogue Gérer les contrôleurs de build
  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 Icône AccueilHome, puis Icône des buildsBuilds.

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

Étapes suivantes

Vérifier le statut de vos contrôleurs et agents
  • Si l'État est Disponible et l'État est Activé, le fonctionnement du composant est probablement correct.

  • Si l'État est Désactivé, vous pouvez sélectionner le composant, sélectionner Propriétés, puis réactiver le composant.

  • Si l'État est Hors ligne, le composant est déconnecté. Connectez-vous au serveur de builds et vérifiez qu'il est inscrit et peut se connecter à votre Team Foundation Server.

Afficher, modifier, activer ou désactiver un contrôleur ou un agent

Sélectionnez-le et choisissez Propriétés, puis consultez Déployer et configurer un contrôleur de build ou Déployer et configurer les agents de build.

Supprimez un contrôleur ou un agent

Consultez Supprimer un contrôleur de build ou Supprimer un agent de build.

Traiter ou résoudre les problèmes avec un serveur, un contrôleur ou un agent de build

Pour plus d'informations, consultez les sections ci-dessous.

Lorsque vous souhaitez contrôler ou gérer vos composants d'un système de génération, vous avez parfois besoin de fonctionnalités supplémentaires qui sont disponibles lorsque vous vous connectez au serveur de builds.

Console d'administration : configuration du serveur de builds
  1. Ouvrez une session sur le serveur de build que vous souhaitez configurer.

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

    La Console Administration Team Foundation s'affiche.

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

  4. Sélectionnez le nœud Configuration de build.

Remarque Remarque

Si le message Configurer les fonctionnalités installéesConfigurer les fonctionnalités installées s'affiche au lieu d'une vue du même type que celle ci-dessus, consultez Déployer un serveur de builds.

Étapes suivantes

Vérifier le statut de vos contrôleurs et agents
Utiliser votre serveur de builds

Configuration du serveur de builds
Utiliser votre contrôleur de build
Contrôleur de build

Utiliser votre agent de build
Agent de build

Il est conseillé d'arrêter le serveur de build chaque fois que vous y effectuez des tâches de maintenance. Dans la Console Administration Team Foundation, choisissez Arrêter pour prendre tous les contrôleurs de build et les agents de build hébergés sur le serveur de builds hors connexion. Sélectionnez Démarrer lorsque vous êtes prêt à remettre les contrôleurs et les agents en service.

Si le serveur de builds ne répond pas (par exemple, si un processus de génération ne peut pas démarrer ou s'il ne parvient pas à progresser correctement), sélectionner Redémarrer peut s'avérer utile. Lorsque vous redémarrez le serveur de builds, le processus de service Team Foundation Build est fermé et relancé dans un état qui est presque aussi actualisé que si vous aviez redémarré l'ordinateur. Si des builds sont en cours de traitement par le contrôleur de build ou les agents de build sur ce serveur de build, ces builds sont annulées.

Lors du redémarrage, le serveur de builds est trop perturbateur ou inutile, vous pouvez choisir le lien Redémarrer du contrôleur de build ou l'agent de build à partir de la Console Administration Team Foundation. Lorsque vous redémarrez un contrôleur de build, celui-ci recharge les assemblys, et toutes les builds qu'il traite sont interrompues. Lorsque vous redémarrez un agent de build, celui-ci ignore le domaine d'application, recharge les assemblys, et la génération qu'il traite est interrompue.

Vous pouvez désactiver un contrôleur Contrôleur de build désactivé ou un agent Agent de build désactivé pour empêcher que des builds leur soient assignés. Si vous désactivez un contrôleur ou un agent qui est en train de traiter une génération, la génération achevée avant le composant est désactivée.

Cette fonction peut vous aider à personnaliser ou à modifier temporairement la façon dont votre système de génération fonctionne. Par exemple, vous pensez qu'un serveur de build exécute actuellement un trop grand nombre d'agents de build, car les builds sont traitées trop lentement. Vous pouvez désactiver certains agents de build et évaluer la façon dont cela affecte les performances. Vous pouvez alors réactiver ultérieurement un ou plusieurs agents de build, si nécessaire.

Pour désactiver ou activer un agent de build ou un contrôleur de build :

  • Dans la boîte de dialogue Gérer les contrôleurs de build de Visual Studio, sélectionnez le contrôleur de build ou l'agent de build que vous souhaitez désactiver ou activer, puis choisissez Propriétés. La boîte de dialogue Propriétés du contrôleur de build ou Propriétés de l'agent de build s'affiche. Désactivez ou activez la case à cocher Le service de contrôleur de build est activé ou Le service Agent de build est activé.

  • Dans la Console Administration Team Foundation, localisez le contrôleur de build ou l'agent de build que vous souhaitez désactiver ou activer, puis sélectionnez le lien Activer ou Désactiver.

Dans la Console Administration Team Foundation, choisissez Annuler l'inscription si vous souhaitez retirer le serveur de builds de votre système de génération. Lorsque vous sélectionnez Annuler l'inscription, il vous est demandé si vous voulez supprimer les contrôleurs de build et les agents de build en cours d'exécution sur le serveur de build.

  • Choisissez Non si vous voulez désactiver temporairement le serveur de build. Les contrôleurs et les agents de ce serveur de builds ne sont pas supprimés de votre collection de projets d'équipe et apparaissent avec un ÉtatHors connexion dans la boîte de dialogue Gérer les contrôleurs de build de Visual Studio. Vous pouvez ensuite sélectionner S'inscrire et restaurer le contrôleur de build et les agents de build.

  • Sélectionnez Oui si vous voulez supprimer de la collection de projets d'équipe tous les paramètres de configuration pour cette build. Toutes les informations relatives au contrôleur de build et aux agents de build sont supprimées.

Si le message Service de build non inscrit s'affiche, vous pouvez sélectionner Inscrire pour réactiver le serveur de build et lui permettre d'héberger des contrôleurs de build et des agents de build.

Conseil Conseil

Vous pouvez également substituer un serveur de builds existant lorsque vous déployez un nouveau serveur de builds. Par exemple, vous pouvez souhaiter héberger la même configuration et le même ensemble de contrôleurs de build et d'agents de build sur un nouvel ordinateur plus puissant. Consultez Configurer le service Team Foundation Build à l'aide de l'outil de configuration de Team Foundation Server.

Puisque vous êtes connecté au serveur de builds, vous pouvez confirmer que service Team Foundation Build est en cours d'exécution, obtenir des informations sur les ressources qu'il utilise, et confirmer l'état général du serveur de builds.

  1. Exécutez le Gestionnaire des tâches Windows (Gestionnaire des tâches sur Windows 8).

  2. Dans Windows 8, si le lien Plus de détails apparaît, sélectionnez-le.

  3. Sélectionnez l'onglet Processus.

  4. Sur les versions de Windows autres que Windows 8, vérifiez que Afficher les processus de tous les utilisateurs est sélectionné.

  5. Sur quelle version de Windows votre serveur de builds s'exécute-il ?

    • Windows 8 : recherchez le processus du service hôte Visual Studio Team Foundation Build. Il doit se trouver dans la section Processus en arrière-plan, ou si votre serveur de builds s'exécute en mode interactif, dans la section Applications. Observez les ressources processeur, mémoire, disque et réseau que le processus utilise.

    • Une autre version de Windows : recherchez le processus TFSBuildServiceHost.exe. Observez les ressources processeur et mémoire que le processus utilise.

  6. Utilisez les autres onglets dans le Gestionnaire des tâches pour vérifier l'état général du serveur de builds. Par exemple, vous pouvez sélectionner l'onglet Performances pour confirmer que l'ordinateur possède des ressources de processeur et de mémoire suffisantes. Vous pouvez ensuite sélectionner le Moniteur de ressources (sur Windows 8, Ouvrir le Moniteur de ressources).

Utilisez l'Observateur d'événements pour obtenir des informations qui peuvent vous aider à surveiller la façon dont votre serveur de builds s'exécute et à diagnostiquer les problèmes avec votre serveur de builds ou votre processus de génération.

Commencez par vérifier les événements les plus récents. Dans la Console Administration Team Foundation, choisissez Événements pour ouvrir l'observateur d'événements et afficher les messages d'information, d'avertissement et d'erreur les plus récents.

Pour obtenir davantage d'informations détaillées sur une plus longue période, dans l'Observateur d'événements, dans le volet d'arborescence, développez Journaux des applications et des services, Microsoft, Team Foundation Server, Build-Services, puis choisissez Opérationnel.

Dans la plupart des cas, vous n'avez pas besoin de lire les messages internes exposés par le journal analytique. Toutefois, ces données peuvent être utiles lorsque vous collaborez avec le support technique pour résoudre un problème.

Pour activer le journal d'analyse

  1. Dans l'Observateur d'événements, choisissez Afficher, Afficher les journaux analytiques et de débogage.

  2. Dans le volet d'arborescence, développez Journaux des applications et des services, Microsoft, Team Foundation Server, Build Services, puis choisissez Analytique.

  3. Lorsque Analytique est encore sélectionné, ouvrez son menu contextuel puis choisissez Activer.

Conseil Conseil

Par défaut, lorsque ce journal atteint la limite de données l'observateur d'événements cesse la collecte de données. Pour modifier la limite ou ce comportement, sélectionnez le nœud Analytique, ouvrez son menu contextuel, puis sélectionnez Propriétés.

Pour enregistrer les données dans un fichier permanent qu'il est facile d'analyser et d'afficher, dans le volet d'arborescence, sélectionnez un des nœuds décrits ci-dessus, ouvrez le menu contextuel, puis choisissez Enregistrer tous les événements. Utilisez la boîte de dialogue Enregistrer sous pour enregistrer les données au format qui répond à vos besoins.

Déployer et utiliser un serveur de build

Pour utiliser Team Foundation Build avec un serveur Team Foundation Server sur site, vous devez déployer au moins un serveur de builds. Le serveur peut être déployé sur un ordinateur physique ou un ordinateur virtuel.

Déployer et configurer un contrôleur de build

Utilisez 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. Vous pouvez héberger un contrôleur de build sur un serveur de builds.

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, lesquelles incluent l'obtention de fichiers du contrôle de version, la configuration de l'espace de travail, la compilation de code et l'exécution de 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.

Afficher: