Sélectionner un emplacement intermédiaire et installer un dossier de dépôt

Lorsque vous définissez ou mettez en file d'attente une définition de build, vous pouvez spécifier un chemin d'accès à un dossier de dépôt pour que votre processus de génération puisse fournir des binaires et des fichiers journaux à votre équipe.Vérifiez que le dossier que vous avez identifié est préparé pour une utilisation comme dossier de dépôt.

Que voulez-vous faire ?

• Installez un dossier cible sur un partage de fichiers pour vos contrôleurs de build sur site.

• Déposez les sorties dans TFS lorsque vous utilisez le contrôleur de build hébergé

Installez un dossier cible sur un partage de fichiers pour vos contrôleurs de build sur site.

Vous pouvez spécifier un chemin d'accès à un partage de fichiers lorsque vous définissez ou mettez en file d'attente une définition de build exécutée par un contrôleur de build sur site.Le contrôleur de build sur site peut être dédié à une collection de projets d'équipe sur le serveur Team Foundation Server (TFS) sur site ou sur le service Team Foundation.

Conseil
Si vous voyez une erreur TF270016 dans votre journal de résultats de build, il est possible que le serveur de builds ne dispose pas des autorisations requises pour accéder au dossier de dépôt.Suivez les instructions ci-dessous pour corriger ce problème.

Configuration requise

Vous devez être membre du groupe de sécurité Administrateurs sur l'ordinateur où se trouve le dossier cible.

Vous pouvez utiliser un dossier de dépôt de partage de fichiers sur les systèmes d'exploitation suivants :

• Windows Server 2012

• Windows Server 2008

• Windows Server 2003

• Windows 8

• Windows 7

• Windows Vista

Pour installer un dossier cible sur un partage de fichiers

1. Ouvrez une session sur l'ordinateur où le dossier de dépôt sera installé.

2. Ouvrez l'Explorateur Windows (« Explorateur de fichiers » dans Windows 8), puis recherchez le dossier qui contient (ou contiendra) le dossier cible.

3. Si nécessaire, créez le dossier de dépôt.

   Conseil
   Faites en sorte que le chemin d'accès au dossier de dépôt soit le plus court possible (par exemple : c:\drops).Le dossier de dépôt ne doit pas entraîner la production, par l'agent de build, de chemins d'accès physiques d'une longueur supérieure à 259 caractères.Sinon, vos builds échoueront et le message d'erreur TF205022 sera généré.

4. Ouvrez le menu contextuel du dossier, choisissez Propriétés, puis choisissez l'onglet Partage.

5. Sous Windows Server 2012, Windows Server 2008, Windows 8, Windows 7 et Windows Vista uniquement : choisissez Partage avancé.

   La boîte de dialogue Partage avancé s'affiche.

6. Sélectionnez Partager ce dossier, puis Autorisations.

   La boîte de dialogue Autorisations pour NomDossier s'affiche.

7. Sélectionnez Ajouter.

   La boîte de dialogue Sélectionnez Utilisateurs, Ordinateurs ou Groupes s'affiche.

8. Effectuez l'une des étapes suivantes, selon le type de compte que vous avez spécifié comme compte de service de build sur le serveur de builds qui héberge votre contrôleur de build :

   • Un SERVICE RÉSEAU qui s'exécute sur l'ordinateur où est installé le dossier cible : dans la zone Entrez les noms d'objets à sélectionner, entrez SERVICE RÉSEAU.

   • Un SERVICE RÉSEAU qui s'exécute sur un autre ordinateur que celui où est installé le dossier de dépôt :

     1. Choisissez Types d'objets.

        La boîte de dialogue Types d'objets s'affiche.

     2. Activez la case à cocher Ordinateurs, puis sélectionnez OK.

     3. Vérifiez que l'emplacement est correct.

     4. Dans la zone Entrez les noms d'objets à sélectionner, entrez OrdinateurBuild$, OrdinateurBuild étant le nom de l'ordinateur de build sur lequel l'agent de build s'exécute.

   • Un compte de domaine : vérifiez que l'emplacement est correct.Dans la zone Entrez les noms d'objets à sélectionner, entrez le nom du compte.

9. Cliquez sur OK.

10. Répétez les deux étapes précédentes pour le compte de service de build sur le serveur de builds qui héberge votre agents de build.

11. Dans la boîte de dialogue Autorisations pour NomDossier, sélectionnez le compte que vous venez d'ajouter dans la liste Noms d'utilisateurs ou de groupes.

12. Activez les cases à cocher Modifier et Lire, puis sélectionnez OK.

Déposez les sorties dans TFS lorsque vous utilisez le contrôleur de build hébergé

Lorsque vous utilisez Visual Studio 2012 Update 1 (ou une version plus récente) pour créer une définition de build et le Contrôleur de build hébergé pour l'exécuter, vous devez supprimer les sorties dans votre serveur de service Team Foundation.

Attention

Bien que le système accepte un dossier cible de contrôle de version en tant qu'emplacement intermédiaire lorsque vous utilisez Team Foundation Service, nous ne recommandons pas cette approche. Si vous utilisez un dossier de dépôt de contrôle de version, vous devez indiquer un dossier destiné à être uniquement utilisé comme dossier de dépôt.Ce dossier ne doit pas contenir de code de votre équipe ni d'autres fichiers sources précieux.Sinon, vous risquez de perdre vos fichiers sources. Pour éviter de diminuer les performances en téléchargeant les fichiers inutiles, vérifiez vos mappages de l'espace de travail de l'ordinateur de développement et les mappages de l'espace de travail de définition de build pour exclure le dossier de dépôt de contrôle de version.

[!REMARQUE]

Si vous utilisez la version finale de Visual Studio 2012 avant la Visual Studio 2012 Update 1 pour modifier la définition de build, l'option Copier sur le serveur la sortie de la génération sera désactivée.

Étapes suivantes

Une fois que vous avez identifié et installé le dossier cible, vous pouvez spécifier le chemin d'accès à ce dossier lorsque vous définissez votre build et lorsque vous mettez une build en file d'attente.