Dela via

Publicera symboler med Azure Pipelines

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Med Azure Pipelines kan du publicera dina symboler till Azure Artifacts-symbolservern med hjälp av Index sources och Publish symbols task. Du kan använda felsökningsprogrammet för att ansluta och automatiskt hämta rätt symbolfiler utan att känna till produktnamn, byggnummer eller paketnamn. Med hjälp av Azure Pipelines kan du också publicera dina symboler på fildelningar och PDB-filer.

Anmärkning

Index-källor och publiceringssymboler uppgift stöds inte i versionspipelines.

Publicera symboler till Azure Artifacts-symbolservern

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Pipelines, välj din pipeline och välj sedan Redigera för att ändra pipelinen.

  3. I pipelinedefinitionen väljer du + för att lägga till en ny uppgift.

  4. Sök efter indexkällor och publicera symboler uppgift. Välj Lägg till för att lägga till den i pipelinen.

  5. Fyll i de obligatoriska fälten på följande sätt:

    • Uppgiftsversion: 2.\*.

    • Visningsnamn: uppgiftsvisningsnamn.

    • Sökväg till symbolmappen: sökväg till mappen som är värd för symbolfilerna.

    • Sökmönster: det mönster som används för att hitta .pdb- filer i mappen som du har angett under Sökväg till symbolmappen. Enkelmapps-jokertecken (*) och rekursiva jokertecken (**) stöds. Exempel: *\bin**.pdb: söker efter alla .pdb-filer i alla underkataloger med namnet bin.

    • Indexkällor: anger om källserverinformation ska matas in i PDB-filerna.

    • Publicera symboler: anger om du vill publicera symbolfilerna.

      • Symbolservertyp: välj symbolserver i den här organisationen/samlingen (kräver Azure Artifacts) publicera dina symboler till Azure Artifacts-symbolservern.

    • Utförlig loggning: inkludera mer information i dina loggar.

Skärmbild som visar hur du konfigurerar indexkällorna och publicerar symboluppgiften för att publicera symboler till Azure Artifacts-symbolservern.

Publicera symboler till en fildelning

Förutom Azure Artifacts-symbolservern kan du även publicera dina symboler till ett filarkiv med hjälp av uppgiften Index Sources and Publish Symbols.

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Pipelines, välj din pipeline och välj sedan Redigera för att ändra pipelinen.

  3. I pipelinedefinitionen väljer du + för att lägga till en ny uppgift.

  4. Sök efter indexkällor och publicera symboler uppgift. Välj Lägg till för att lägga till den i pipelinen.

  5. Fyll i de obligatoriska fälten på följande sätt:

    • Uppgiftsversion: 2.\*.

    • Visningsnamn: uppgiftsvisningsnamn.

    • Sökväg till symbolmappen: sökväg till mappen som är värd för symbolfilerna.

    • Sökmönster: det mönster som används för att hitta .pdb- filer i mappen som du har angett under Sökväg till symbolmappen.

    • Indexkällor: anger om källserverinformation ska matas in i PDB-filerna.

    • Publicera symboler: anger om du vill publicera symbolfilerna.

      • symbolservertyp: välj Fildelning för att publicera dina symboler till en fildelning.
      • Sökväg för att publicera symboler: den filresurs som ska vara värd för dina symboler.

    • Utförlig loggning: kontrollera om du vill inkludera mer information i loggarna.

    Skärmbild som visar hur du konfigurerar indexkällor och uppgiften för att publicera symboler till en fildelning.

Publicera portabla PDF-filer till Azure Artifacts-symbolservern

Bärbara PDF-filer är symbolfiler som kan skapas och användas på alla plattformar till skillnad från traditionella PDF-filer som endast används i Windows. För bärbara PDF-filer utför versionen indexeringen, men du måste fortfarande använda uppgiften Indexkällor och Publicera symboler för att publicera dina symboler.

Source Link är en uppsättning verktyg som gör det möjligt för utvecklare att felsöka sin källkod genom att mappa från .NET-sammansättningarna tillbaka till källkoden. Kolla in dotnet/sourcelink GitHub-lagringsplats för att lära dig mer om de olika paket som ingår.

  • För projekt som finns på GitHub lägger du till Microsoft.SourceLink.GitHub-paketreferensen i projektfilen.

    <ItemGroup>
  <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" PrivateAssets="All"/>
</ItemGroup>

  • För projekt som finns på Azure Repos (tidigare Visual Studio Team Services) lägger du till Microsoft.SourceLink.AzureRepos.Git-paketreferensen i projektfilen.

    <ItemGroup>
  <PackageReference Include="Microsoft.SourceLink.AzureRepos.Git" Version="1.1.1" PrivateAssets="All"/>
</ItemGroup>

  • För projekt som finns på Azure DevOps Server (tidigare Team Foundation Server) lägger du till Microsoft.SourceLink.AzureDevOpsServer.Git-paketreferensen i projektfilen.

    <ItemGroup>
  <PackageReference Include="Microsoft.SourceLink.AzureDevOpsServer.Git" Version="1.1.1" PrivateAssets="All"/>
</ItemGroup>

Konfigurera publiceringsaktiviteten

Uppgiften Indexera källor & Publicera symboler används för att indexera källkoden och publicera symboler till Azure Artifacts symbolserver och fildelningar. Eftersom vi använder Source Linkmåste vi inaktivera indexering i publiceringsaktiviteten.

  1. Logga in på din Azure DevOps-organisation och navigera sedan till projektet.

  2. Välj Pipelines, välj din pipeline och välj sedan Redigera för att ändra pipelinen.

  3. I pipelinedefinitionen väljer du + för att lägga till en ny uppgift.

  4. Sök efter indexkällor och publicera symboler uppgift. Välj Lägg till för att lägga till den i pipelinen.

  5. Fyll i de obligatoriska fälten och välj symbolserver för servertypen Symbol. Kontrollera att du avmarkerar Indexkällor för att inaktivera indexering.

    En skärmbild som visar hur du konfigurerar publiceringsaktiviteten för att publicera bärbara PDF-filer till Azure Artifacts-symbolservern.

Viktigt!

För att ta bort symboler som publicerats via indexkällor & publicera symboler uppdrag, måste du först ta bort den build som genererade dessa symboler. Detta kan åstadkommas med hjälp av lagringspolicyer eller genom att ta bort körningen manuellt.

Konfigurera Visual Studio

Anmärkning

Visual Studio för Mac stöder inte felsökning med hjälp av symbolservrar.

Innan du börjar använda våra symboler från Azure Artifacts-symbolservern ska vi se till att Visual Studio har konfigurerats korrekt:

  1. I Visual Studio väljer du Verktyg och sedan Alternativ.

  2. Välj Symboler på menyn Felsökning.

  3. Välj +-tecknet för att lägga till en ny symbolserverplats.

    Skärmbild som visar hur du lägger till en ny symbolserverplats.

  4. En ny dialogruta visas, välj ditt konto på den nedrullningsbara menyn och välj sedan den organisation som du vill ansluta till. Välj Anslut när du är klar.

  5. Välj Allmänt från samma felsökningsavsnitt. Rulla nedåt och markera Aktivera stöd för källlänk för att aktivera stöd för bärbara PDB-filer.

    En skärmbild som visar hur du aktiverar stöd för källlänkar i Visual Studio.

Anmärkning

Om du kontrollerar Alternativet Aktivera källserverstöd kan du använda källserver i fall där källkoden inte är tillgänglig lokalt eller om symbolfilen inte matchar källkoden. Om du vill aktivera felsökning för källkod från tredje part avmarkerar du kryssrutan Aktivera Just My Code.

Vanliga frågor och svar

F: Hur länge behålls symboler?

S: En symbolfil har samma kvarhållningsperiod som den version som genererade den. När du tar bort en version manuellt eller med hjälp av kvarhållningsprinciper tas även de symboler som genererades av den versionen bort.

F: Kan jag använda källindexering på en bärbar PDB som genererats från en .NET Core-sammansättning?

S: Detta är inte möjligt för tillfället. Källindexering stöds för närvarande inte för bärbara PDF-filer. Den rekommenderade metoden är att konfigurera din version för att göra indexeringen.