Manage Your Build System

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 Autorisations de Team Foundation Server.

Que voulez-vous faire ?

• Vérifier le statut, gérer et modifier vos contrôleurs et agents à partir de Visual Studio

• Vérifier le statut, gérer et modifier votre serveur, votre contrôleur et vos agents à partir de la console Administration

• Démarrez, arrêtez ou redémarrez un serveur de builds

• Redémarrer un contrôleur de build ou un agent de build

• Activer ou désactiver un contrôleur ou un agent

• Spécifiez le nombre maximal de builds exécutées simultanément pour un contrôleur

• Enregistrez ou annulez l'inscription d'un serveur de builds

• Surveiller l'état de votre serveur de builds

• Utiliser les journaux des événements pour diagnostiquer les problèmes

• Passez aux étapes suivantes

Vérifier le statut, gérer et modifier vos contrôleurs et agents à partir de Visual Studio

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.

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.

É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 des 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.

Vérifier le statut, gérer et modifier votre serveur, votre contrôleur et vos agents à partir de la console Administration

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.

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]

Si le message Configurer 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

  • Si l'un des contrôleurs de build ou des agents de build est en train de traiter une génération, vous pouvez consulter des messages relatifs au travail en cours en temps réel à partir de la Console Administration Team Foundation.

    

    Pour plus d'informations sur la surveillance d'un processus de génération en cours de exécution, consultez Exécuter, surveiller et gérer des builds et Diagnostiquer des problèmes de build.

  • Si un contrôleur ou un agent est rouge, le composant est déconnecté.Vérifiez que votre serveur de builds peut se connecter à votre Team Foundation Server.

• Utiliser votre serveur de builds

  

  • Sélectionnez Redémarrer, Arrêter ou Démarrer pour démarrer, arrêter ou redémarrez le serveur de builds.

  • Sélectionnez Propriétés pour déployer et configurer un serveur de builds.

  • Sélectionnez S'inscrire ou Annuler l'inscription pour enregistrer ou annuler l'inscription d'un serveur de builds.

  • Sélectionnez Événements… pour utiliser les journaux des événements pour diagnostiquer des problèmes.

  • Surveillez l'état de votre serveur de builds.

• Utiliser votre contrôleur de build
  

  • Choisissez Propriétés et consultez Déployer et configurer un contrôleur de build.

  • Sélectionnez Redémarrer pour redémarrer le contrôleur.

  • Sélectionnez Activer ou Désactiver pour activer ou désactiver le contrôleur.

• Utiliser votre agent de build
  

  • Choisissez Propriétés et consultez Déployer et configurer des agents de build.

  • Sélectionnez Redémarrer pour redémarrer l'agent.

  • Sélectionnez Activer ou Désactiver pour activer ou désactiver l'agent.

Démarrez, arrêtez ou redémarrez un serveur de builds

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.

Redémarrer un contrôleur de build ou un agent de build

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.

Activer ou désactiver un contrôleur ou un agent

Vous pouvez désactiver un contrôleur ou un agent 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.

Enregistrez ou annulez l'inscription d'un serveur de builds

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

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.

Surveiller l'état de votre serveur de builds

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

Utiliser les journaux des événements pour diagnostiquer les problèmes

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.

Afficher les événements récents

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.

Afficher le journal opérationnel

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.

Afficher le journal d'analyse

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

Personnaliser et afficher les données

Pour enregistrer les données dans un fichier permanent, 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.

Étapes suivantes

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