Visual Studio Team System
Comment : créer un type de build

Team Foundation Build utilise des types de build pour configurer les conditions sous lesquelles une solution unique ou un ensemble de solutions dans un projet d'équipe sera généré. Pour effectuer une génération, vous devez créer un type de build ou utiliser un type de build existant.

  • Lorsque vous créez des types de build à l'aide de l'Assistant Création d'un nouveau type de build d'équipe, vous pouvez définir plusieurs options. Ces options incluent le mode de numérotation des builds, les étapes de génération, le nettoyage du répertoire de build et la synchronisation des sources. Team Foundation ne possède aucune interface utilisateur pour modifier ces options après leur définition. Pour ajouter vos propres étapes de génération ou modifier le type de build, vous pouvez modifier le fichier XML TeamBuild.proj en utilisant un éditeur XML. Pour plus d'informations, consultez Comment : modifier un type de build. Vous pouvez substituer les options par défaut en modifiant le fichier de type de build qui est écrit au format MSBuild.

  • Les étapes de génération des types de build peuvent être personnalisées en modifiant le fichier Microsoft.TeamBuild.targets.

  • Les types de build sont supprimés en supprimant directement les fichiers du contrôle de code source. Pour plus d'informations, consultez Comment : supprimer un type de build.

Les types de build sont créés en utilisant l'Assistant Création d'un nouveau type de build d'équipe, comme décrit dans la procédure suivante.

Pour créer un type de build, procédez comme suit :

  1. Dans l'Explorateur d'équipes, sélectionnez le projet pour lequel vous souhaitez créer un type de build.

  2. Dans le menu Générer, sélectionnez Nouveau type de build d'équipe.

    L'Assistant Création d'un nouveau type de build d'équipe apparaît.

  3. Dans l'Assistant Création d'un nouveau type de build d'équipe, spécifiez le nom à associer au type de build dans la zone de texte Quel nom souhaitez-vous donner à ce type de build d'équipe ?.

    Une validation est effectuée afin de vérifier que le nom entré existe déjà pour un type de build établi. Si le nom existe, vous êtes invité à entrer un nom unique. Le nom du type de build doit être un nom de fichier Windows valide et ne peut pas contenir le symbole $.

    Ajoutez une description appropriée dans la zone de texte Description, puis cliquez sur Suivant pour continuer.

    L'étape Sélectionnez et classez les solutions à générer apparaît.

    RemarqueConseil

    Le bouton Suivant est uniquement activé lorsque tous les champs obligatoires sont correctement renseignés.

  4. Dans la zone de liste déroulante Depuis quel espace de travail souhaitez-vous sélectionner les solutions à générer, sélectionnez l'espace de travail qui contient les solutions à inclure dans le type de build. L'option affiche le nom de l'espace de travail et l'utilisateur qui l'a créé.

  5. Dans la liste Sélectionnez et classez les solutions, sélectionnez la ou les solutions que vous souhaitez ajouter au type de build. Utilisez l'option Sélectionner tout pour sélectionner une solution, plusieurs solutions ou toutes les solutions.

  6. Utilisez les touches de direction situées à droite de la liste pour sélectionner les solutions et modifier leur emplacement dans l'ordre de la génération. Les solutions sont générées de façon ordonnée, en commençant en haut de la liste.

    Remarque AttentionAttention

    Tenez compte des dépendances d'une solution vis-à-vis d'une autre lorsque vous déterminez l'ordre de la génération des solutions. Par exemple, si Solution2 a une dépendance vis-à-vis de Solution1, définissez la génération de Solution1 avant celle de Solution2. Lorsque les solutions sélectionnées et l'ordre de génération spécifié répondent à vos besoins, cliquez sur Suivant. L'étape Sélectionnez les configurations à générer apparaît.

    RemarqueRemarque

    Si un branchement est effectué, les types de build du nouveau branchement doivent être modifiés pour spécifier les chemins d'accès corrects. Pour plus d'informations, consultez Comment : mettre à jour les types de build dans des projets d'équipe avec branches et Branchement et fusion du contrôle de code source Team Foundation.

  7. Dans la grille sous Quelles configurations souhaitez-vous générer ?, sélectionnez la configuration et les plateformes à inclure dans la build. La configuration de génération indique la configuration et la plateforme souhaitée, par exemple, Retail et Any UC.

    RemarqueRemarque

    Si un projet utilise un paramètre de configuration différent dans le Gestionnaire de configuration de celui qui est spécifié dans l'Assistant Création d'un nouveau type de build d'équipe, le projet sera ignoré.

    RemarqueRemarque

    Si vous créez un type de build pour les projets Web, sélectionnez Plateformes mixtes.

  8. Lorsque les sélections de configuration de génération répondent à vos besoins, cliquez sur Suivant.

    L'étape Sélectionnez l'emplacement de build apparaît.

  9. Dans la zone de texte Sur quel ordinateur souhaitez-vous générer les solutions sélectionnées ?, tapez le nom de l'ordinateur, par exemple MachineA_Lab1.

  10. Dans la zone de texte Répertoire de build sur l'ordinateur sélectionné, tapez le répertoire où vous souhaitez que la génération se produise. Il s'agit d'un répertoire local sur l'ordinateur de build. Par exemple, D:\AdventureWorks\TourPackeServices\.

    Remarque AttentionAttention

      Lors de la sélection du répertoire de build, assurez-vous que l'espace est suffisant pour la build. Si l'espace est insuffisant, les générations échoueront.

    RemarqueRemarque

    Le répertoire de build ne peut pas être un répertoire mappé.

  11. Dans la zone de texte Emplacement cible, tapez l'emplacement UNC (\\serveur\partage) ou utilisez Parcourir pour rechercher un emplacement cible. L'emplacement cible est le lieu de stockage des binaires et des fichiers journaux créés à la fin de la génération.

    • Par défaut, le répertoire cible n'est pas créé automatiquement comme un répertoire de partage et, par conséquent, il ne permet pas de publier des builds et des résultats de tests. Vous devez établir un partage manuellement. Afin d'éviter que des utilisateurs non autorisés suppriment des emplacements cibles de build, il est déconseillé d'établir des autorisations de suppression sur le partage.

    • Chaque build générée sera située dans un répertoire séparé. Vous devrez vérifier que le compte avec lequel l'ordinateur de build est configuré dispose d'un accès en écriture à cet emplacement UNC. L'autorisation d'écriture est également requise pour le compte sous lequel la couche Application est configurée.

    Remarque AttentionAttention

      Les binaires et les fichiers journaux créés copiés dans le répertoire cible ne peuvent pas être sécurisés. Vous pouvez étendre le type de build avec une tâche MSBuild personnalisée qui copie de façon sécurisée ces fichiers vers le répertoire cible. Pour plus d'informations sur l'extension d'un type de build, consultez Procédure pas à pas : personnalisation de Team Foundation Build avec une tâche personnalisée.

  12. Lorsque les paramètres d'emplacement de build répondent à vos besoins, cliquez sur Suivant.

    L'étape Sélectionnez les options de build apparaît.

  13. Indiquez les options de build que vous souhaitez sélectionner en activant les cases à cocher Série de tests (par exemple, exécution de tests de vérification (BVT) de la génération, etc.) et Exécuter l'analyse du code, le cas échéant. Si la case à cocher Série de tests (exécution de tests de vérification (BVT) de la génération, etc.) est activée, utilisez les options déroulantes pour spécifier les options Fichier de métadonnées de test et Liste de tests à exécuter, si approprié. Pour plus d'informations, consultez Utilisation des listes de test et Écriture de code de qualité..

  14. Lorsque les étapes de génération répondent à vos besoins, cliquez sur Suivant.

    L'étape Vérifiez les types de build sélectionnés apparaît.

  15. Si le type de build répond à vos besoins, cliquez sur Terminer. Le nouveau type de build crée les fichiers sous-jacents. Les fichiers suivants sont créés :

    • TeamBuild.proj

    • WokspaceMapping.xml

    Ces fichiers sont archivés dans le contrôle de code source Team Foundation sous le dossier qui porte le même nom que le « type de build ». Par exemple, si vous créez un type de build nommé "myBuildType", dans le contrôle de code source Team Foundation, les fichiers sont stockés dans $/[Nom Projet d'équipe/TeamBuildType/myBuildType.

    RemarqueRemarque

    Si vous souhaitez continuer à modifier le type de build, vous devrez modifier le fichier teambuild.proj.

    Une fois les étapes de l'Assistant terminées, vous devez vous assurer que les autorisations appropriées ont été définies pour le type de build que vous venez de créer. Pour plus d'informations, consultez Comment : établir des autorisations pour un ordinateur Team Foundation Build.

Sécurité

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.

Voir aussi

Mots clés :


Page view tracker