Diagnostiquer des problèmes après le déploiementDiagnose problems after deployment

Si vous souhaitez utiliser IntelliTrace pour diagnostiquer les problèmes dans votre application web ASP.NET après son déploiement, ajoutez les informations de build à votre version pour permettre à Visual Studio de trouver automatiquement les fichiers sources et fichiers de symboles correspondants nécessaires pour déboguer l’application à l’aide du journal IntelliTrace.To diagnose issues in your ASP.NET web app after deployment by using IntelliTrace, include build information with your release to let Visual Studio automatically find the correct source files and symbol files that are required to debug the IntelliTrace log.

Si vous utilisez Microsoft Monitoring Agent pour contrôler IntelliTrace, vous devez également configurer l’analyse des performances de l’application sur votre serveur web.If you are using Microsoft Monitoring Agent to control IntelliTrace, you also need to set up set up application performance monitoring on your web server. Cela permet d’enregistrer des événements de diagnostic pendant l’exécution de votre application et d’enregistrer les événements dans un fichier journal IntelliTrace.This records diagnostic events while your app runs and saves the events to an IntelliTrace log file. Vous pouvez ensuite examiner les événements dans Visual Studio Enterprise (mais pas Professional ni Community), accéder au code où l’événement s’est produit, observer les valeurs enregistrées à cet instant donné, et avancer ou reculer dans le code qui a été exécuté.You can then look at the events in Visual Studio Enterprise (but not Professional or Community editions), go to the code where an event happened, look at the recorded values at that point in time, and move forwards or backwards through the code that ran. Après avoir identifié et corrigé le problème, répétez le cycle de génération, publication et surveillance de votre version, de sorte à pouvoir résoudre les éventuels problèmes futurs plus tôt et plus vite.After you find and fix the problem, repeat the cycle to build, release, and monitor your release so you can resolve future potential problems earlier and faster.

Code, générer, mise en production, surveiller, diagnostiquer, résoudreCode, build, release, monitor, diagnose, fix

Vous aurez besoin :You'll need:

  • Visual Studio 2017, Visual Studio 2015 ou Team Foundation Server 2017, 2015, 2013, 2012 ou 2010 pour paramétrer votre buildVisual Studio 2017, Visual Studio 2015, or Team Foundation Server 2017, 2015, 2013, 2012, or 2010 to set up your build

  • Microsoft Monitoring Agent pour surveiller votre application et enregistrer les données de diagnosticMicrosoft Monitoring Agent to monitor your app and record diagnostic data

  • Visual Studio Enterprise (mais pas Professional ni Community) pour vérifier les données de diagnostic et déboguer votre code avec IntelliTraceVisual Studio Enterprise (but not Professional or Community editions) to review diagnostic data and debug your code with IntelliTrace

Étape 1 : Ajouter les informations à votre version de buildStep 1: Include build information with your release

Paramétrez votre processus de génération de sorte à créer un manifeste de build (fichier BuildInfo.config) pour votre projet web et ajoutez ce manifeste à votre version.Set up your build process to create a build manifest (BuildInfo.config file) for your web project and include this manifest with your release. Ce manifeste contient des informations sur le projet, le contrôle de code source et le système de génération utilisés pour créer une build spécifique.This manifest contains information about the project, source control, and build system that were used to create a specific build. Ces informations aident Visual Studio à trouver la source et les symboles correspondants après ouverture du journal IntelliTrace pour examiner les événements enregistrés.This information helps Visual Studio find the matching source and symbols after you open the IntelliTrace log to review the recorded events.

Créer le manifeste de build pour une build automatisée à l’aide de Team Foundation ServerCreate the build manifest for an automated build using Team Foundation Server

Procédez comme suit si vous utilisez le contrôle de version ou le fournisseur Git Team Foundation.Follow these steps whether you use Team Foundation Version Control or Git.

Team Foundation Server 2017Team Foundation Server 2017

Configurer votre pipeline de génération à ajouter l’emplacement de votre source, build et de symboles au manifeste de build (fichier BuildInfo.config).Set up your build pipeline to add the locations of your source, build, and symbols to the build manifest (BuildInfo.config file). Team Foundation Build crée automatiquement ce fichier et le place dans le dossier de sortie de votre projet.Team Foundation Build automatically creates this file and puts it in your project's output folder.

  1. Si vous disposez déjà d’un pipeline de génération en utilisant le modèle ASP.NET Core (.NET Framework), vous pouvez soit modifier votre pipeline de génération ou de créer un pipeline de build.If you already have a build pipeline using the ASP.NET Core (.NET Framework) template, you can either Edit your build pipeline or create a new build pipeline.

    Afficher la build dans TFS 2017 pipelineView build pipeline in TFS 2017

  2. Si vous créez un nouveau modèle, choisissez le modèle ASP.NET Core (.NET Framework).If you create a new template, choose the ASP.NET Core (.NET Framework) template.

    Choisissez le modèle de processus de génération - TFS 2017Choose build process template - TFS 2017

  3. Spécifiez l’emplacement où enregistrer le fichier de symboles (PDB) de sorte que votre source soit indexée automatiquement.Specify where to save the symbols (PDB) file so that your source is indexed automatically.

    Si vous utilisez un modèle personnalisé, vérifiez que le modèle a une activité pour indexer votre source.If you use a custom template, make sure the template has an activity to index your source. Vous ajouterez plus tard un argument MSBuild pour spécifier l’emplacement où enregistrer les fichiers de symboles.You'll later add an MSBuild argument to specify where to save the symbols files.

    Définir le chemin d’accès des symboles dans le pipeline de build TFS 2017Set up symbols path in build pipeline TFS 2017

    Pour plus d’informations sur les symboles, consultez publier des données symboles.For more about symbols, see Publish symbol data.

  4. Ajoutez cet argument MSBuild pour inclure les emplacements de votre TFS et des symboles dans le fichier manifeste de la build :Add this MSBuild argument to include your TFS and symbols locations in the build manifest file:

    /p:IncludeServerNameInBuildInfo = true/p:IncludeServerNameInBuildInfo=True

    Toute personne pouvant accéder à votre serveur web peut consulter ces emplacements dans le manifeste de build.Anyone who can access your web server can see these locations in the build manifest. Vérifiez que votre serveur source est sécurisé.Make sure that your source server is secure.

  5. Exécutez une nouvelle build.Run a new build.

    Accédez à étape 2 : publier votre applicationGo to Step 2: Release your app

Team Foundation Server 2013Team Foundation Server 2013

Configurer votre pipeline de génération à ajouter l’emplacement de votre source, build et de symboles au manifeste de build (fichier BuildInfo.config).Set up your build pipeline to add the locations of your source, build, and symbols to the build manifest (BuildInfo.config file). Team Foundation Build crée automatiquement ce fichier et le place dans le dossier de sortie de votre projet.Team Foundation Build automatically creates this file and puts it in your project's output folder.

  1. Modifier votre pipeline de génération ou de créer un pipeline de build.Edit your build pipeline or create a new build pipeline.

    Afficher la build dans TFS 2013 pipelineView build pipeline in TFS 2013

  2. Choisissez le modèle par défaut (TfvcTemplate.12.xaml) ou votre propre modèle personnalisé.Choose the default template (TfvcTemplate.12.xaml) or your own custom template.

    Choisissez le modèle de processus de génération - TFS 2013Choose build process template - TFS 2013

  3. Spécifiez l’emplacement où enregistrer le fichier de symboles (PDB) de sorte que votre source soit indexée automatiquement.Specify where to save the symbols (PDB) file so that your source is indexed automatically.

    Si vous utilisez un modèle personnalisé, vérifiez que le modèle a une activité pour indexer votre source.If you use a custom template, make sure the template has an activity to index your source. Vous ajouterez plus tard un argument MSBuild pour spécifier l’emplacement où enregistrer les fichiers de symboles.You'll later add an MSBuild argument to specify where to save the symbols files.

    Définir le chemin d’accès des symboles dans le pipeline de build TFS 2013Set up symbols path in build pipeline TFS 2013

    Pour plus d’informations sur les symboles, consultez publier des données symboles.For more about symbols, see Publish symbol data.

  4. Ajoutez cet argument MSBuild pour inclure les emplacements de votre TFS et des symboles dans le fichier manifeste de la build :Add this MSBuild argument to include your TFS and symbols locations in the build manifest file:

    /p:IncludeServerNameInBuildInfo = true/p:IncludeServerNameInBuildInfo=True

    Toute personne pouvant accéder à votre serveur web peut consulter ces emplacements dans le manifeste de build.Anyone who can access your web server can see these locations in the build manifest. Vérifiez que votre serveur source est sécurisé.Make sure that your source server is secure.

  5. Si vous utilisez un modèle personnalisé, ajoutez l’argument MSBuild suivant pour spécifier l’emplacement où enregistrer le fichier de symboles :If you use a custom template, add this MSBuild argument to specify where to save the symbols file:

    / p : buildsymbolstorepath =<chemin d’accès aux symboles>/p:BuildSymbolStorePath=<path to symbols>

    Inclure les informations de serveur de build dans la définition de build TFS 2013Include build server info in build def TFS 2013

    Ajoutez ces lignes à votre fichier projet web (.csproj, .vbproj) :And add these lines to your web project file (.csproj, .vbproj):

    <!-- Import the targets file. Change the folder location as necessary. -->
       <Import Project=""$(MSBuildExtensionsPath)\Microsoft\VisualStudio\v$(VisualStudioVersion)\BuildInfo\Microsoft.VisualStudio.ReleaseManagement.BuildInfo.targets" />
    

    Toute personne pouvant accéder à votre serveur web peut consulter ces emplacements dans le manifeste de build.Anyone who can access your web server can see these locations in the build manifest. Vérifiez que votre serveur source est sécurisé.Make sure that your source server is secure.

  6. Exécutez une nouvelle build.Run a new build.

    Accédez à étape 2 : publier votre applicationGo to Step 2: Release your app

Team Foundation Server 2012 ou 2010Team Foundation Server 2012 or 2010

Procédez comme suit pour créer automatiquement le manifeste de build (fichier BuildInfo.config) pour votre projet et le placer dans le dossier de sortie de votre projet.Follow these steps to automatically create the build manifest (BuildInfo.config file) for your project and put the file in your project's output folder. Le fichier s’affiche avec le nom «Nom_projet.BuildInfo.config » dans le dossier de sortie, mais est renommé en « BuildInfo.config » dans le dossier de déploiement une fois l’application publiée.The file appears as "ProjectName.BuildInfo.config" in the output folder but is renamed "BuildInfo.config" in the deployment folder after you publish your app.

  1. Installez Visual Studio 2013 (n’importe quelle édition) sur votre serveur Team Foundation Build.Install Visual Studio 2013 (any edition) on your Team Foundation build server.

  2. Dans votre pipeline de build, spécifiez où enregistrer les symboles afin que votre source soit indexée automatiquement.In your build pipeline, specify where to save the symbols so that your source is indexed automatically.

    Si vous utilisez un modèle personnalisé, vérifiez que le modèle a une activité pour indexer votre source.If you use a custom template, make sure that the template has an activity to index your source.

  3. Ajoutez ces arguments MSBuild à votre pipeline de génération :Add these MSBuild arguments to your build pipeline:

    • /p:VisualStudioVersion = 12.0/p:VisualStudioVersion=12.0

    • /p:MSBuildAssemblyVersion = 12.0/p:MSBuildAssemblyVersion=12.0

    • /TV:12.0/tv:12.0

    • /p:IncludeServerNameInBuildInfo = true/p:IncludeServerNameInBuildInfo=True

    • / p : buildsymbolstorepath =<chemin d’accès aux symboles>/p:BuildSymbolStorePath=<path to symbols>

  4. Exécutez une nouvelle build.Run a new build.

    Accédez à étape 2 : publier votre applicationGo to Step 2: Release your app

Créer le manifeste de build pour une génération manuelle à l’aide de Visual StudioCreate the build manifest for a manual build using Visual Studio

Procédez comme suit pour créer automatiquement le manifeste de build (fichier BuildInfo.config) pour votre projet et le placer dans le dossier de sortie de votre projet.Follow these steps to automatically create the build manifest (BuildInfo.config file) for your project and put the file in your project's output folder. Le fichier s’affiche avec le nom «Nom_projet.BuildInfo.config » dans le dossier de sortie, mais est renommé en « BuildInfo.config » dans le dossier de déploiement une fois l’application publiée.The file appears as "ProjectName.BuildInfo.config" in the output folder but is renamed "BuildInfo.config" in the deployment folder after you publish your app.

  1. Dans l’ Explorateur de solutions, déchargez votre projet web.In Solution Explorer, unload your web project.

  2. Ouvrez le fichier projet (.csproj, .vbproj).Open the project file (.csproj, .vbproj). Ajoutez les lignes suivantes :Add these lines:

    <!-- **************************************************** -->
    <!-- Build info -->
    <PropertyGroup>
       <!-- Generate the BuildInfo.config file -->
       <GenerateBuildInfoConfigFile>True</GenerateBuildInfoConfigFile>
       <!-- Include server name in build info -->
       <IncludeServerNameInBuildInfo>True</IncludeServerNameInBuildInfo>
       <!-- Include the symbols path so Visual Studio can find the matching deployed code when you start debugging. -->
       <BuildSymbolStorePath><path to symbols></BuildSymbolStorePath>
    </PropertyGroup>
    <!-- **************************************************** -->
    
  3. Archivez le fichier projet mis à jour.Check in the updated project file.

  4. Exécutez une nouvelle build.Run a new build.

    Accédez à étape 2 : publier votre applicationGo to Step 2: Release your app

Créer le manifeste de build pour une génération manuelle à l’aide de MSBuild.exeCreate the build manifest for a manual build using MSBuild.exe

Ajoutez les arguments de build suivants quand vous exécutez une build :Add these build arguments when you run a build:

/p:GenerateBuildInfoConfigFile = true/p:GenerateBuildInfoConfigFile=True

/p:IncludeServerNameInBuildInfo = true/p:IncludeServerNameInBuildInfo=True

/ p : buildsymbolstorepath =<chemin d’accès aux symboles>/p:BuildSymbolStorePath=<path to symbols>

Étape 2 : Publier votre applicationStep 2: Release your app

Si vous utilisez le package Web.Deploy qui a été créé par votre processus de génération pour déployer votre application, le manifeste de build est renommé automatiquement à partir de «nom_projet. BuildInfo.config » en « BuildInfo.config » et est placé dans le même dossier avec le fichier Web.config de votre application sur votre serveur web.If you use the Web.Deploy package that was created by your build process to deploy your app, the build manifest is automatically renamed from "ProjectName.BuildInfo.config" to "BuildInfo.config" and is put in the same folder with your app's Web.config file on your web server.

Si vous utilisez d’autres méthodes pour déployer votre application, assurez-vous que le manifeste de build «Nom_projet.BuildInfo.config » est renommé en « BuildInfo.config » et qu’il est placé dans le même dossier que le fichier Web.config de votre application sur le serveur web.If you use other methods to deploy your app, make sure that the build manifest is renamed from "ProjectName.BuildInfo.config" to "BuildInfo.config" and is put in the same folder with your app's Web.config file on the web server.

Étape 3 : Surveiller votre applicationStep 3: Monitor your app

Paramétrez la surveillance des performances de l’application sur votre serveur web de sorte à pouvoir surveiller si votre application rencontre des problèmes, enregistrer des événements de diagnostic et enregistrer ces événements dans un fichier journal IntelliTrace.Set up application performance monitoring on your web server so that you can monitor your app for problems, record diagnostic events, and save those events to an IntelliTrace log file. Consultez surveiller votre version pour les problèmes de déploiement.See Monitor your release for deployment problems.

Étape 4 : Identifier le problèmeStep 4: Find the problem

Vous devez installer Visual Studio Enterprise sur votre ordinateur de développement ou un autre ordinateur pour examiner les événements enregistrés et déboguer votre code à l’aide d’IntelliTrace.You'll need Visual Studio Enterprise on your development computer or another computer to review the recorded events and debug your code using IntelliTrace. Vous pouvez aussi utiliser des outils comme CodeLens, les cartes de débogueur et les cartes de code pour vous aider à diagnostiquer le problème.You can also use tools like CodeLens, debugger maps, and code maps to help you diagnose the problem.

Ouvrir le journal IntelliTrace et la solution correspondanteOpen the IntelliTrace log and matching solution

  1. Ouvrez le journal IntelliTrace (fichier .iTrace) dans Visual Studio Enterprise.Open the IntelliTrace log (.iTrace file) from Visual Studio Enterprise. Si Visual Studio Enterprise est installé sur le même ordinateur, il vous suffit de double-cliquer sur le fichier.Or just double-click the file if you have Visual Studio Enterprise on the same computer.

  2. Choisissez Ouvrir une solution pour que Visual Studio ouvre automatiquement la solution ou le projet correspondant, si le projet n’a pas été généré dans le cadre d’une solution.Choose Open solution to have Visual Studio automatically open the matching solution or project, if the project wasn't built as part of a solution. Q : le journal IntelliTrace manque des informations relatives à mon application déployée. Comment est-ce possible ? Que dois-je faire ?Q: The IntelliTrace log is missing information about my deployed app. Why did this happen? What do I do?

    Visual Studio réserve automatiquement toutes les modifications en attente quand il ouvre la solution ou le projet correspondant.Visual Studio automatically shelves any pending changes when it opens the matching solution or project. Pour obtenir plus de détails sur ce jeu de réservations, consultez la fenêtre Sortie ou Team Explorer.To get more details about this shelveset, look in the Output window or Team Explorer.

    Avant d’effectuer des modifications, vérifiez que la source est correcte.Before you make any changes, confirm that you have the correct source. Si vous utilisez la création de branche, vous travaillez peut-être dans une branche différente de celle dans laquelle Visual Studio trouve la source correspondante, comme votre branche de publication.If you use branching, you might be working in a different branch than where Visual Studio finds the matching source, like your release branch.

    Ouvrez la solution à partir du fichier journal IntelliTraceOpen solution from IntelliTrace log

    Si un espace de travail existant est mappé à cette solution ou ce projet, Visual Studio le sélectionne pour y placer la source trouvée.If you have an existing workspace mapped to this solution or project, Visual Studio selects that workspace to put the source that it found.

    Ouvrir à partir du contrôle de code source à l’espace de travail mappéOpen from source control to mapped workspace

    Sinon, choisissez un autre espace de travail ou créez-en un.Otherwise, choose another workspace or create a new workspace. Visual Studio mappera la branche entière à cet espace de travail.Visual Studio will map the entire branch to this workspace.

    Ouvrir à partir du contrôle de code source - créer le nouvel espace de travailOpen from source control - create new workspace

    Pour créer un espace de travail avec des mappages spécifiques ou un nom qui n’est pas celui de votre ordinateur, choisissez Gérer.To create a workspace with specific mappings or a name that's not your computer name, choose Manage.

    Q : pourquoi Visual Studio indique-t-il que mon espace de travail sélectionné est inéligible ?Q: Why does Visual Studio say my selected workspace is ineligible?

    Q : Pourquoi ne puis-je pas continuer jusqu'à ce que je choisisse une collection d’équipe ou une autre collection ?Q: Why can't I continue until I choose a team collection or a different collection?

Diagnostiquer un problème de performanceDiagnose a performance problem

  1. Sous Violations de performances, examinez les événements de performance enregistrés, leurs durées totales d’exécution et les autres informations associées.Under Performance Violations, review the recorded performance events, their total execution times, and other event information. Approfondissez ensuite les méthodes appelées pendant un événement de performance spécifique.Then dig deeper into the methods that were called during a specific performance event.

    Afficher les détails de l’événement performancesView performance event details

    Vous pouvez aussi uniquement double-cliquer sur l’événement.You can also just double-click the event.

  2. Dans la page d’événement, examinez les durées d’exécution de ces appels.On the event page, review the execution times for these calls. Recherchez un appel lent dans l’arborescence d’exécution.Find a slow call in the execution tree.

    Les appels les plus lents s’affichent dans leur propre section quand vous avez plusieurs appels, imbriqués ou non.The slowest calls appear in their own section when you have multiple calls, nested or otherwise.

    Développez cet appel pour examiner les appels imbriqués et les valeurs qui ont été enregistrés à ce moment précis.Expand that call to review any nested calls and values that were recorded at that point in time. Démarrez ensuite le débogage à partir de cet appel.Then start debugging from that call.

    Démarrer le débogage à partir de l’appel de méthodeStart debugging from method call

    Vous pouvez aussi simplement double-cliquer sur l’appel.You can also just double-click the call.

    Si la méthode se trouve dans votre code d’application, Visual Studio y accède.If the method is in your application code, Visual Studio goes to that method.

    Accédez au code d’application à partir de l’événement de performancesGo to application code from performance event

    Vous pouvez maintenant examiner d’autres valeurs enregistrées, la pile des appels, parcourir votre code ou utiliser la fenêtre IntelliTrace pour remonter ou avancer « dans le temps » entre d’autres méthodes appelées pendant cet événement de performance.Now you can review other recorded values, the call stack, step through your code, or use the IntelliTrace window to move backwards or forwards "in time" between other methods that were called during this performance event.

Diagnostiquer une exceptionDiagnose an exception

  1. Sous Données d’exception, examinez les événements d’exception enregistrés, leurs types, leurs messages et à quel moment les exceptions se sont produites.Under Exception Data, review the recorded exception events, their types, messages, and when the exceptions happened. Pour approfondir le code, démarrez le débogage à partir de l’événement le plus récent d’un groupe d’exceptions.To dig deeper into the code, start debugging from the most recent event in a group of exceptions.

    Démarrer le débogage à partir de l’événement d’exceptionStart debugging from exception event

    Vous pouvez aussi uniquement double-cliquer sur l’événement.You can also just double-click the event.

    Si l’exception s’est produite dans votre code d’application, Visual Studio accède à l’emplacement où l’exception s’est produite.If the exception happened in your application code, Visual Studio goes to where the exception happened.

    Accédez au code d’application à partir d’un événement d’exceptionGo to application code from an exception event

    Vous pouvez maintenant examiner d’autres valeurs enregistrées, la pile des appels, ou utiliser la fenêtre IntelliTrace pour remonter ou avancer « dans le temps » entre les autres événements enregistrés, le code connexe et les valeurs enregistrées à ces moments précis.Now you can review other recorded values, the call stack, or use the IntelliTrace window to move backwards or forwards "in time" between other recorded events, related code, and the values recorded at those points in time.

    Qu’est toutes ces autres événements et informations dans le journal IntelliTrace ?What's all these other events and information in the IntelliTrace log?

Que puis-je faire d’autre à partir d’ici ?What else can I do from here?

Q et RQ & A

Q : Pourquoi incluent des informations sur mon projet, contrôle de code source, build et des symboles à ma version ?Q: Why include information about my project, source control, build, and symbols with my release?

Visual Studio utilise ces informations pour trouver la solution et la source correspondant à la version que vous tentez de déboguer.Visual Studio uses this information to find the matching solution and source for the release that you're trying to debug. Après avoir ouvert le journal IntelliTrace et sélectionné un événement pour démarrer le débogage, Visual Studio utilise des symboles pour trouver et vous indiquer le code où l’événement s’est produit.After you open the IntelliTrace log and select an event to start debugging, Visual Studio uses symbols to find and show you the code where the event happened. Vous pouvez alors examiner les valeurs enregistrées et avancer ou reculer dans l’exécution de votre code.You can then look at the values that were recorded and move forwards or backwards through your code's execution.

Si vous n’utilisez pas TFS et que ces informations n’est pas dans le manifeste de build (fichier BuildInfo.config), Visual Studio recherche la source correspondante et les symboles sur votre TFS actuellement connecté.If you're using TFS and this information isn't in the build manifest (BuildInfo.config file), Visual Studio looks for the matching source and symbols on your currently connected TFS. Si Visual Studio ne peut pas trouver le TFS correct ou la source correspondante, vous êtes invité à choisir un autre TFS.If Visual Studio can't find the correct TFS or matching source, you're prompted to choose a different TFS.

Q : le journal IntelliTrace manque des informations relatives à mon application déployée.Q: The IntelliTrace log is missing information about my deployed app. Comment est-ce possible ?Why did this happen? Que dois-je faire ?What do I do?

Cela peut se produire quand vous déployez à partir de votre ordinateur de développement ou que vous n’êtes pas connecté à TFS pendant le déploiement.This might happen when you deploy from your development computer or you're not connected to TFS during deployment.

  1. Accédez au dossier de déploiement de votre projet.Go to your project's deployment folder.

  2. Trouvez et ouvrez le manifeste de build (fichier BuildInfo.config).Find and open the build manifest (BuildInfo.config file).

  3. Vérifiez que le fichier contient les informations requises :Make sure the file has the required information:

  • ProjectNameProjectName

    Nom de votre projet dans Visual Studio.The name of your project in Visual Studio. Exemple :For example:

    <ProjectName>FabrikamFiber.Extranet.Web</ProjectName>
    
  • SourceControlSourceControl

  • Informations sur votre système de contrôle de code source et les propriétés requises suivantes :Information about your source control system and these required properties:

    • TFSTFS

      • ProjectCollectionUri: URI de votre serveur Team Foundation Server et de la collection de projetsProjectCollectionUri: The URI for your Team Foundation Server and project collection

      • ProjectItemSpec: chemin d’accès au fichier projet de votre application (.csproj ou .vbproj)ProjectItemSpec: The path to your app's project file (.csproj or .vbproj)

      • ProjectVersionSpec: version de votre projetProjectVersionSpec: The version for your project

        Exemple :For example:

      <SourceControl type="TFS">
         <TfsSourceControl>
            <ProjectCollectionUri>http://fabrikamfiber:8080/tfs/FabrikamFiber</ProjectCollectionUri>
            <ProjectItemSpec>$/WorkInProgress/FabrikamFiber/FabrikamFiber.CallCenter/FabrikamFiber.Web/FabrikamFiber.Web.csproj</ProjectItemSpec>
            <ProjectVersionSpec>LFabrikamFiber_BuildAndPublish_20130813@$/WorkInProgress</ProjectVersionSpec>
         </TfsSourceControl>
      </SourceControl>
      
    • GitGit

      • GitSourceControl: emplacement du schéma GitSourceControlGitSourceControl: The location of the GitSourceControl schema

      • RepositoryUrl: URI de votre serveur Team Foundation Server, de la collection de projets et du référentiel GitRepositoryUrl: The URI for your Team Foundation Server, project collection, and Git repository

      • ProjectPath: chemin d’accès au fichier projet de votre application (.csproj ou .vbproj)ProjectPath: The path to your app's project file (.csproj or .vbproj)

      • CommitId: ID de votre validationCommitId: The id for your commit

        Exemple :For example:

      <SourceControl type="Git">
         <GitSourceControl xmlns="http://schemas.microsoft.com/visualstudio/deploymentevent_git/2013/09">
            <RepositoryUrl>http://gittf:8080/tfs/defaultcollection/_git/FabrikamFiber</RepositoryUrl>
            <ProjectPath>/FabrikamFiber.CallCenter/FabrikamFiber.Web/FabrikamFiber.Web.csproj</ProjectPath>
            <CommitId>50662c96502dddaae5cd5ced962d9f14ec5bc64d</CommitId>
         </GitSourceControl>
      </SourceControl>
      
  • GénérerBuild

    Informations sur votre système de génération, "TeamBuild" ou "MSBuild", et les propriétés requises suivantes :Information about your build system, either "TeamBuild" or "MSBuild", and these required properties:

    • BuildLabel (pour TeamBuild) : nom et numéro de votre build.BuildLabel (for TeamBuild): The build name and number. Cette étiquette est également utilisée comme nom de l’événement de déploiement.This label is also used as the name of the deployment event. Pour plus d’informations sur les numéros de build, consultez utilisez numéros de build pour attribuer des noms pertinents aux builds terminées.For more info about build numbers, see Use build numbers to give meaningful names to completed builds.

    • SymbolPath (recommandé) : liste des URI des emplacements de vos symboles (fichier PDB), séparés par des points-virgules.SymbolPath (Recommended): The list of URIs for your symbols (PDB file) locations separated by semi-colons. Les URI peuvent être des URL ou des chemins d’accès réseau (UNC).These URIs can be URLs or UNCs. Il est alors plus facile pour Visual Studio de rechercher les symboles correspondants pour vous aider avec le débogage.This makes it easier for Visual Studio to find the matching symbols to help you with debugging.

    • BuildReportUrl (pour TeamBuild) : emplacement du rapport de la build dans TFSBuildReportUrl (for TeamBuild): The location of the build report in TFS

    • BuildId (pour TeamBuild) : URI des détails de votre build dans TFS.BuildId (for TeamBuild): The URI for the build details in TFS. Cet URI est également utilisé comme ID de l’événement de déploiement.This URI is also used as the ID of the deployment event. Cet ID doit être unique si vous n’utilisez pas TeamBuild.This must id must be unique if you're not using TeamBuild.

    • BuiltSolution: chemin d’accès au fichier de la solution, utilisé par Visual Studio pour rechercher et ouvrir la solution correspondante.BuiltSolution: The path to the solution file that Visual Studio uses to find and open the matching solution. Contenu de la propriété MSBuild SolutionPath .This is the contents of the SolutionPath MsBuild property.

      Exemple :For example:

    • TFSTFS

      <Build type="TeamBuild">
         <MsBuild>
            <BuildLabel kind="label">FabrikamFiber_BuildAndPublish_20130813.1</BuildLabel>
            <SymbolPath>\\fabrikamfiber\FabrikamFiber.CallCenter\Symbols</SymbolPath>
            <BuildReportUrl kind="informative, url" url="http://fabrikamfiber:8080/tfs/FabrikamFiber/_releasePipeline/FindRelease?buildUri=fabrikamfiber%3a%2f%2f%2fBuild%2fBuild%2f448">Build Report Url</BuildReportUrl>
            <BuildId kind="id">1c4444d2-518d-4673-a590-dce2773c7744,fabrikamfiber:///Build/Build/448</BuildId>
            <BuiltSolution>$/WorkInProgress/FabrikamFiber/FabrikamFiber.CallCenter/FabrikamFiber.CallCenter.sln</BuiltSolution>
         </MsBuild>
      </Build>
      
    • GitGit

      <Build type="MSBuild">
         <MSBuild>
            <SymbolPath>\\gittf\FabrikamFiber.CallCenter\Symbols</SymbolPath>
            <BuiltSolution>/FabrikamFiber.CallCenter/FabrikamFiber.CallCenter.sln</BuiltSolution>
         </MSBuild>
      </Build>
      

Q : pourquoi Visual Studio indique-t-il que mon espace de travail sélectionné est inéligible ?Q: Why does Visual Studio say my selected workspace is ineligible?

R : L’espace de travail sélectionné ne possède aucun mappage entre le dossier de contrôle de code source et un dossier local.A: The selected workspace doesn't have any mappings between the source control folder and a local folder. Pour créer un mappage de cet espace de travail, choisissez Gérer.To create a mapping for this workspace, choose Manage. Sinon, choisissez un espace de travail déjà mappé ou créez-en un.Otherwise, choose an already mapped workspace or create a new workspace.

Ouvrir à partir du contrôle de code source avec aucun espace de travail mappéOpen from source control with no mapped workspace

Q : Pourquoi ne puis-je pas continuer jusqu'à ce que je choisisse une collection d’équipe ou une autre collection ?Q: Why can't I continue until I choose a team collection or a different collection?

R : Cela peut se produire pour l’une des raisons suivantes :A: This might happen for any of these reasons:

  • Visual Studio n’est pas connecté à TFS.Visual Studio isn't connected to TFS.

    Ouvrir à partir du contrôle de code source - non connectéOpen from source control - not connected

  • Visual Studio n’a pas trouvé la solution ou le projet dans votre collection d’équipe actuelle.Visual Studio didn't find the solution or project in your current team collection.

    Quand les fichier de manifeste de la build (<nom_projet>. BuildInfo.config) ne spécifie pas où Visual Studio peut trouver la source correspondante, Visual Studio utilise votre TFS actuellement connecté pour rechercher la solution correspondante ou le projet.When the build manifest file (<ProjectName>.BuildInfo.config) doesn't specify where Visual Studio can find the matching source, Visual Studio uses your currently connected TFS to find the matching solution or project. Si votre collection d’équipe actuelle ne dispose pas de la source correspondante, Visual Studio vous invite à vous connecter à une autre collection d’équipe.If your current team collection doesn't have the matching source, Visual Studio prompts you to connect to a different team collection.

  • Visual Studio n’a pas trouvé la solution ou le projet dans la collection spécifiée par le fichier de manifeste de build (<nom_projet>. BuildInfo.config).Visual Studio didn't find the solution or project in the collection specified by the build manifest file (<ProjectName>.BuildInfo.config).

    Il est possible que le TFS spécifié ne dispose plus de la source correspondante ou qu’il n’existe plus, par exemple si vous avez migré vers un nouveau TFS.The specified TFS might not have the matching source anymore or even exist, maybe because you migrated to a new TFS. Si le TFS spécifié n’existe pas, Visual Studio peut expirer après environ une minute et vous inviter à vous connecter à une autre collection.If the specified TFS doesn't exist, Visual Studio might time out after a minute or so, and then prompt you to connect to a different collection. Pour continuer, connectez-vous au serveur TFS approprié.To continue, connect to the correct TFS server.

    Ouvrir à partir du contrôle de code source - migréOpen from source control - migrated

Q : qu’est un espace de travail ?Q: What's a workspace?

R : votre espace de travail stocke une copie de la source afin de pouvoir développer et tester séparément avant d’archiver votre travail.A: Your workspace stores a copy of the source so you can develop and test it separately before you check in your work. Si vous ne disposez pas déjà d’un espace de travail spécialement mappé à la solution ou au projet trouvé, Visual Studio vous invite à choisir un espace de travail disponible ou à en créer un avec le nom de votre ordinateur comme nom d’espace de travail par défaut.If you don't have already have a workspace that's specifically mapped to the found solution or project, then Visual Studio prompts you to choose an available workspace or create a new workspace with your computer name as the default workspace name.

Q : je reçois ce message sur les symboles non fiables ?Q: Why do I get this message about untrusted symbols?

Déboguer avec le chemin d’accès des symboles non fiables ? Debug with untrusted symbols path?

R : ce message apparaît lorsque le chemin d’accès de symboles dans le fichier de manifeste de build (<nom_projet>. BuildInfo.config) n’est pas inclus dans la liste des chemins d’accès des symboles approuvés.A: This message appears when the symbols path in the build manifest file (<ProjectName>.BuildInfo.config) isn't included in the list of trusted symbol paths. Vous pouvez ajouter le chemin d’accès à la liste des chemins de symboles dans les options du débogueur.You can add the path to the symbols path list in the debugger options.