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

Mise à jour : novembre 2007

Cette procédure pas à pas vous indique comment configurer une définition de build pour Team Foundation Build. Avant de commencer à suivre cette procédure pas à pas, vous devez avoir quelques connaissances de base de Team Foundation Build. Pour plus d'informations, consultez Gestion des builds avec Team Foundation Build.

Cette procédure pas à pas vous guide dans le processus de configuration d'une définition de build, à l'aide de la boîte de dialogue Définition de build. Vous établirez également les autorisations requises pour l'agent de build et les utilisateurs qui exécuteront les définitions de build nouvellement créées. Dans cette procédure pas à pas, vous effectuerez les tâches suivantes :

• Créer une définition de build.

• Sélectionner les solutions à générer.

• Sélectionner un agent de build et un emplacement cible.

• Sélectionner des étapes de génération.

• Sélectionner une configuration et les plateformes pour la build.

• Établir des autorisations sur l'agent de build.

• Établir des autorisations pour les utilisateurs spécifiés qui leur permettront d'exécuter la définition de build nouvellement créée.

Composants requis

• Visual Studio Team System Team Foundation Server.

• Une connexion à un serveur Team Foundation Server et au moins un projet d'équipe existant. Pour plus d'informations, consultez Procédure pas à pas : rejoindre d'un projet d'équipe et Comment : créer un projet d'équipe.

• Un espace de travail sur le serveur de contrôle de code source contenant au moins une solution à générer. Pour plus d'informations, consultez Comment : créer un espace de travail mappé.

Autorisations requises

Pour exécuter cette procédure pas à pas, vous devez disposer de l'autorisation Administrer une build avec la valeur Autoriser. De plus, le compte de service de couche Application et le compte de service Team Foundation Build doivent avoir des autorisations de lecture/écriture sur l'emplacement cible de la build. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Pour créer une définition de build

1. Dans Team Explorer, sélectionnez le projet pour lequel vous souhaitez créer une définition de build.

2. Dans le menu Générer, sélectionnez Nouvelle définition de build.

   La boîte de dialogue Définition de build apparaît avec l'onglet Général sélectionné.

   Conseil :
   Les onglets affichant une icône d'avertissement requièrent l'entrée de données.

3. Spécifiez le nom que vous souhaitez attribuer à la définition de build dans la zone de texte Nom de définition de build.

   Le nom que vous entrez doit être un nom de fichier Windows unique et valide.

4. Ajoutez une description appropriée dans la zone de texte Description.

   Cette description apparaît dans la boîte de dialogue Mettre en file d'attente la build "<nom du projet d'équipe>". Pour plus d'informations, consultez Comment : démarrer ou mettre en file d'attente une définition de build.

5. Cliquez sur l'onglet Espace de travail.

   Le tableau Dossiers de travail inclut par défaut le dossier du contrôle de code source pour le projet d'équipe pour lequel vous créez les définitions de build. Un dossier local qui reflète la hiérarchie de contrôle de code source est créé sur l'agent de build. La colonne Dossier local indique le dossier local de l'agent de build. Tous les chemins d'accès aux espaces de travail de l'agent de build sont mappés en fonction du répertoire racine par défaut affiché.

6. Pour copier un espace de travail existant vers la liste de dossiers de travail, cliquez sur le bouton Copier l'espace de travail existant pour ouvrir la boîte de dialogue Sélectionner un espace de travail.

   L'espace de travail que vous sélectionnez est normalisé en répertoire racine commun de l'agent de build.

   Vous pouvez également cliquer sur une cellule vide du tableau dans Dossier du contrôle de code source, puis cliquez sur le bouton de sélection (...) pour naviguer jusqu'au dossier du contrôle de code source à ajouter comme dossier de travail. Le dossier du contrôle de code source que vous sélectionnez est également fonction du répertoire racine commun de l'agent de build.

7. Cliquez sur l'onglet Fichier projet. Dans le volet Fichier projet, vous pouvez naviguer jusqu'à un fichier projet TFSBuild.proj existant ou lancer l'Assistant Création de fichier de projet MSBuild pour créer un fichier TFSBuild.proj.

8. Pour naviguer jusqu'à un dossier TFSBuild.proj existant, cliquez sur Parcourir. Dans la boîte de dialogue Rechercher un dossier, sélectionnez une définition de build existante dans le dossier TeamBuildTypes, puis cliquez sur OK.

   Le fichier TFSBuild.proj est maintenant partagé entre la nouvelle définition de build et l'existante.

   Si un fichier TFSBuild.proj a été trouvé, le texte Le fichier de projet MSBuild a été trouvé : TFSBuild.proj apparaît dans le volet Fichier projet. S'il ne trouve aucun fichier projet, le volet Fichier projet affiche un avertissement et vous recommande de créer un fichier projet MSBuild.

   Remarque importante :
   Toute modification apportée à un fichier TFSBuild.proj partagé personnalise toutes les définitions de build auxquelles le fichier est associé. Pour plus d'informations, consultez Personnalisation de Team Foundation Build.

9. Pour créer un fichier projet pour votre définition de build, cliquez sur Créer.

   L'Assistant Création de fichier de projet MSBuild apparaît.

   1. Sur la page Sélectionnez et classez les solutions à générer, sélectionnez les solutions à générer. Pour trier les solutions, sélectionnez-en une et utilisez les touches de direction situées à droite de la liste pour modifier sa position dans l'ordre de la génération.

      Attention :
      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 Solution2, placez Solution1 avant Solution2.

   2. Cliquez sur Suivant.

      La page Sélectionnez les configurations à générer apparaît.

   3. Dans la grille sous Quelles configurations souhaitez-vous générer ?, sélectionnez la configuration et les plateformes à inclure dans vos définitions de build. La configuration de génération indique la configuration et la plateforme souhaitées (par exemple, Release et AnyCPU).

      Remarque :
      Si vous créez une définition de build pour les projets Web, sélectionnez Plateformes mixtes.

   4. Cliquez sur Suivant.

      La page Sélectionnez les options de build apparaît.

   5. 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 (par exemple, exécution de tests de vérification (BVT) de la génération, etc.) est activée, utilisez les listes 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é..

      Remarque importante :
      Pour réaliser des tests, Visual Studio Test Edition doit être installé sur l'agent de build. Pour effectuer l'analyse du code, Development Edition doit être installé sur l'agent de build.

   6. Cliquez sur Terminer.

      Le volet Fichier projet de la boîte de dialogue Définition de build apparaît. Le fichier TFSBuild.proj que vous avez créé est stocké sous $<Projet d'équipe>\TeamBuild Types\<Nom du type de build>\TFSBuild.proj dans le contrôle de code source.

10. Cliquez sur l'onglet Stratégie de rétention.

    1. Dans la liste Spécifier comment les builds doivent être conservées, vous pouvez sélectionner la stratégie de rétention pour les builds non réussies, arrêtées, partiellement réussies et parfaitement réussies.

    2. Sélectionnez une stratégie de rétention dans la liste déroulante.

       Si vous sélectionnez <Spécifier le nombre à conserver>, la boîte de dialogue Nombre de builds apparaît.

    3. Dans la zone de texte Spécifier le nombre de builds à conserver, indiquez combien de builds vous souhaitez garder pour le résultat de build spécifié.

11. Cliquez sur l'onglet Valeurs par défaut des builds.

    1. Dans le volet Valeurs par défaut des builds, vous pouvez choisir un agent de build existant dans la liste déroulante Agent de build.

    2. Si aucun agent de build n'existe ou vous souhaitez en créer un, cliquez sur Nouveau.

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

    3. Complétez les zones de texte Nom complet, Description et Nom d'ordinateur et cliquez sur OK.

       Pour plus d'informations, consultez Comment : créer et gérer des agents de build.

    Dans la zone de texte Les builds auront lieu sur le partage suivant (par exemple, \\serveur\partage), tapez l'emplacement UNC (\\serveur\partage). Les fichiers binaires et journaux créés seront enregistrés dans ce dossier une fois la build terminée.

    Remarque importante :
    Avant de procéder à cette étape, vous devez d'abord créer un dossier public sur l'ordinateur d'agent de build où le compte TFSService a des droits complets. Pour plus d'informations sur les comptes de service Team Foundation, consultez Comment : afficher les services Team Foundation Server.

    Remarque :
    Chaque build générée sera déplacée dans un répertoire séparé. Vous devrez veiller à que le compte avec lequel l'ordinateur de build est configuré dispose d'un accès en écriture vers cet emplacement UNC.

12. Cliquez sur l'onglet Déclencheur.

    1. Dans le volet Déclencheur, sélectionnez Les archivages ne déclenchent pas une nouvelle build pour les builds à la demande uniquement.

    2. Sélectionnez Générer chaque archivage (plus de builds) pour générer une build à chaque archivage d'une modification apportée aux fichiers spécifiés dans votre définition de build.

    3. Sélectionnez Accumuler les archivages jusqu'à ce que la build précédente se termine (moins de builds) pour créer des builds enchaînées.

       Si vous activez la case à cocher Accumuler les archivages jusqu'à ce que la build précédente se termine (moins de builds), vous pouvez indiquer l'intervalle entre les builds en activant la case à cocher Générer au maximum toutes les et en entrant un nombre dans la zone de texte minutes. La plage valide pour la zone de texte minutes s'étend de 0 à 2147483647 (Int32 MaxValue).

    4. Sélectionnez Générer chaque semaine les jours suivants pour créer des builds planifiées. Sélectionnez chaque jour où générer des builds à l'aide des cases à cocher en regard de chaque jour de la semaine. Indiquez l'heure de build dans la zone de texte Mettre la build en file d'attente sur l'agent de build par défaut à.

       Remarque :
       Les builds planifiées ne seront pas générées si aucune modification n'a été archivée depuis la dernière build.

13. Cliquez sur OK pour créer votre définition de build une fois que vous avez fourni toutes les informations requises.

    La définition de build créée apparaît dans le dossier Builds de Team Explorer.

14. Pour consulter les informations stockées sur le serveur pour votre définition de build, cliquez dessus avec le bouton droit dans Team Explorer et cliquez sur Modifier la définition de build.

    La boîte de dialogue Définition de build s'ouvre et affiche les informations que vous avez entrées. Vous pouvez les modifier. Pour plus d'informations, consultez Comment : modifier une définition de build.

    Remarque importante :
    Si votre définition de build partage un fichier TFSBuild.proj avec une autre build, votre définition et les fichiers associés n'apparaissent pas dans l'Explorateur du contrôle de code source à l'emplacement par défaut, sous le dossier TeamBuildTypes. Seule la définition de build initiale est répertoriée. Vous pouvez également stocker le fichier TFSBuild.proj dans un autre emplacement.

Pour établir des autorisations de build

1. Contactez l'administrateur système de l'ordinateur de build que vous avez préalablement sélectionné et déterminez le nom du compte sous lequel le service Visual Studio Team Foundation Build est exécuté.

2. Dans le menu Équipe, sélectionnez Paramètres du projet d'équipe, puis Appartenance au groupe.

   La boîte de dialogue Groupes de projets s'affiche.

3. Dans la boîte de dialogue Groupes de projets, dans la liste Utilisateur et groupes, recherchez le groupe appelé Build Services et cliquez sur Propriétés.

   La boîte de dialogue Propriétés du groupe Team Foundation Server apparaît.

4. Sélectionnez l'onglet Membres.

   Si le nom du compte obtenu à l'étape précédente est présent dans la liste des membres, l'ordinateur de build sélectionné peut générer cette définition de build. Sinon, procédez comme suit :

5. Dans Ajouter un membre, choisissez Utilisateur ou groupe Windows et cliquez sur Ajouter.

   La boîte de dialogue Sélectionner les utilisateurs ou les groupes s'affiche.

6. Dans la boîte de dialogue Sélectionner les utilisateurs ou les groupes, entrez le compte associé au service Visual Studio Team Foundation Build sur l'ordinateur de build utilisé pour cette définition de build.

   Remarque :
   Si cette définition de build est générée à partir de plusieurs agents de build, tous les comptes de service Visual Studio Team Foundation Build doivent être ajoutés comme membres du groupe « Build Services » de ce projet.

7. Configurez les utilisateurs qui doivent exécuter des définitions de build en leur accordant l'autorisation de démarrer/reprendre une build.

Voir aussi

Tâches

Procédure pas à pas : exécution d'une définition de génération dans Team Foundation Build

Comment : configurer et installer Team Foundation Build

Comment : créer une définition de build

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

Référence

Start, commande (Team Foundation Build)