Partager via


Comment : créer et gérer des agents de build

Mise à jour : novembre 2007

Avant de créer une définition de build, vous devez d'abord configurer un ordinateur désigné comme agent de build. Pour plus d'informations, consultez Comment : configurer et installer Team Foundation Build. Après avoir installé Team Foundation Build et les composants nécessaires sur un ou plusieurs ordinateurs, vous pouvez utiliser l'interface utilisateur Visual Studio Team System pour créer des agents de build ou gérer ceux existants. Chaque agent de build ne peut être associé qu'à un seul port. Dans la plupart des cas, cela signifie que chaque agent de build est associé à un ordinateur de build. Toutefois, vous pouvez également spécifier un port interactif que vous pouvez utiliser en exécutant tfsbuildservice.exe à partir de la ligne de commande. Le port interactif vous permet d'effectuer des tests qui impliquent l'ouverture et la fermeture de Windows Forms. Pour plus d'informations, consultez Paramètres du fichier TfsBuildService.exe.config dans les composants Team Foundation Server et Comment : configurer un port interactif pour Team Foundation Build.

Autorisations requises

Pour exécuter cette procédure, vous devez disposer de l'autorisation Administrer une build avec la valeur Autoriser. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Création d'un agent de build

Utilisez la boîte de dialogue Gérer les agents de build pour désigner un ordinateur comme agent de build.

Pour créer un agent de build

  1. Sélectionnez le projet d'équipe auquel vous souhaitez associer l'agent de build dans Team Explorer.

  2. Dans le menu Générer, cliquez sur Gérer les agents de build.

    La boîte de dialogue Gérer les agents de build apparaît.

  3. Cliquez sur Nouveau.

    La boîte de dialogue Propriétés de l'agent de build s'affiche.

  4. Tapez le nom de l'agent de build dans la zone de texte Nom complet.

    La boîte de dialogue Gérer les agents de build affiche le nom.

  5. Ajoutez une description facultative dans la zone de texte Description.

    Par exemple, « Cet agent de build est dédié aux builds tournantes ».

  6. Dans la zone de texte Nom de l'ordinateur, entrez le nom d'un ordinateur sur lequel Team Foundation Build est installé.

  7. Dans la zone de texte Port de communication, entrez le numéro de port que Team Foundation utilise pour communiquer avec Team Foundation Build.

    La valeur par défaut est 9191. Pour plus d'informations sur les ports utilisés par Team Foundation, consultez Architecture de sécurité de Team Foundation Server.

  8. Activez la case à cocher Canal sécurisé requis (HTTPS) si votre agent de build doit requérir HTTPS et SSL (Secure Sockets Layer).

    Pour plus d'informations sur les étapes à suivre pour utiliser HTTPS, consultez Comment : configurer un agent de build pour l'utilisation de HTTPS et SSL (Secure Sockets Layer).

  9. Dans la zone de texte Répertoire de travail, entrez une valeur pour le répertoire de travail de l'agent de build.

    La valeur par défaut est $(Temp)\$(BuildDefinitionPath). La propriété BuildDefinitionPath se développe en <Projet d'équipe>\<Nom de la définition de build>. Vous pouvez également utiliser BuildDefinitionId qui se développe en un identificateur entier propre à la définition de génération. BuildDefinitionId est utilisé normalement pour créer un chemin d'accès plus court.

    Remarque :

    Cliquez sur le bouton Par défaut pour rétablir les zones de texte Communications et Répertoire de travail à leurs valeurs par défaut.

    L'état de l'agent par défaut est activé. D'autres valeurs sont affichées pour refléter l'état de l'agent.

Modification et suppression d'agents de build

Vous pouvez également utiliser la boîte de dialogue Gérer les agents de build pour modifier et supprimer des agents de build désignés.

Pour supprimer un agent de build

  1. Sélectionnez le projet d'équipe qui contient l'agent de build à supprimer dans Team Explorer.

  2. Dans le menu Générer, cliquez sur Gérer les agents de build.

    La boîte de dialogue Gérer les agents de build apparaît.

  3. Sélectionnez l'agent de build à supprimer dans la liste Agents de build, puis cliquez sur Supprimer.

    L'agent de build est supprimé de la liste.

Pour modifier un agent de build

  1. Sélectionnez le projet d'équipe qui contient l'agent de build à modifier dans Team Explorer.

  2. Dans le menu Générer, cliquez sur Gérer les agents de build.

    La boîte de dialogue Gérer les agents de build apparaît.

  3. Sélectionnez l'agent de build à modifier dans la liste Agents de build et cliquez sur Modifier.

    La boîte de dialogue Propriétés de l'agent de build s'affiche.

  4. Dans la boîte de dialogue Propriétés de l'agent de build, vous pouvez modifier chacune des entrées, puis cliquez sur OK pour les enregistrer.

  5. Pour désactiver un agent de build, sélectionnez Désactivé dans le menu déroulant État de l'agent.

    Lorsque l'état de l'agent de build a la valeur Désactivé, toutes les builds en file d'attente resteront dans la file d'attente dans un état actif jusqu'à ce que l'agent de build soit de nouveau Activé.

Voir aussi

Tâches

Procédure pas à pas : création d'une définition de build dans Team Foundation Build

Comment : établir des autorisations pour un agent Team Foundation Build

Comment : configurer et installer Team Foundation Build

Procédure pas à pas : personnalisation de Team Foundation Build avec une tâche personnalisée

Concepts

Vue d'ensemble de Team Foundation Build

Autres ressources

Utilisation de définitions de build dans Team Foundation Build