Symbolen publiceren met Azure Pipelines

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Met Azure Pipelines kunt u uw symbolen publiceren naar de server met symbolen van Azure Artifacts met behulp van de indexbronnen en de taak symbolen publiceren. U kunt het foutopsporingsprogramma gebruiken om verbinding te maken en automatisch de juiste symboolbestanden op te halen zonder productnamen, buildnummers of pakketnamen te kennen. Met Behulp van Azure Pipelines kunt u uw symbolen ook publiceren naar bestandsshares en draagbare PDF-bestanden.

Notitie

De taak Indexbronnen en publicatiesymbolen wordt niet ondersteund in release-pijplijnen.

Symbolen publiceren naar de symboolserver van Azure Artifacts

Klassiek

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Pijplijnen, selecteer uw pijplijn en selecteer Vervolgens Bewerken om uw pijplijn te wijzigen.

3. Selecteer in uw pijplijndefinitie of u + een nieuwe taak wilt toevoegen.

4. Zoek naar de indexbronnen en publiceer symbolen . Selecteer Toevoegen om deze toe te voegen aan uw pijplijn.

5. Vul de vereiste velden als volgt in:

   • Taakversie: 2.\*.

   • Weergavenaam: weergavenaam van taak.

   • Pad naar map symbolen: pad naar de map die als host fungeert voor de symboolbestanden.

   • Zoekpatroon: het patroon dat wordt gebruikt om de PDB-bestanden te vinden in de map die u hebt aangewezen onder Pad naar de map symbolen. Jokertekens met één map (*) en recursieve jokertekens (**) worden beide ondersteund. Voorbeeld: *\bin**.pdb: zoekt naar alle .pdb-bestanden in alle submappen met de naam bin.

   • Indexbronnen: geeft aan of bronservergegevens moeten worden ingevoerd in de PDB-bestanden.

   • Symbolen publiceren: geeft aan of de symboolbestanden moeten worden gepubliceerd.

     • Symboolservertype: selecteer Symboolserver in deze organisatie/verzameling (vereist Azure Artifacts) om uw symbolen te publiceren naar de symboolserver van Azure Artifacts.

   • Uitgebreide logboekregistratie: neem meer informatie op in uw logboeken.

YAML

Als u uw symbolen wilt publiceren naar de symboolserver van Azure Artifacts, voegt u het volgende fragment toe aan uw YAML-pijplijn:

- task: PublishSymbols@2
  inputs:
    SymbolsFolder: '$(Build.SourcesDirectory)'
    SearchPattern: '**/bin/**/*.pdb'
    IndexSources: true
    PublishSymbols: true
    SymbolServerType: 'TeamServices' 
    SymbolExpirationInDays: '36530'
    IndexableFileFormats: 'Default'
    DetailedLog: true
    SymbolsArtifactName: 'Symbols_$(BuildConfiguration)'

Symbolen publiceren naar een bestandsshare

Naast de symboolserver van Azure Artifacts kunt u uw symbolen ook publiceren naar een bestandsshare met behulp van de taak Indexbronnen en Symbolen publiceren .

Klassiek

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Pijplijnen, selecteer uw pijplijn en selecteer Vervolgens Bewerken om uw pijplijn te wijzigen.

3. Selecteer in uw pijplijndefinitie of u + een nieuwe taak wilt toevoegen.

4. Zoek naar de indexbronnen en publiceer symbolen . Selecteer Toevoegen om deze toe te voegen aan uw pijplijn.

5. Vul de vereiste velden als volgt in:

   • Taakversie: 2.\*.

   • Weergavenaam: weergavenaam van taak.

   • Pad naar map symbolen: pad naar de map die als host fungeert voor de symboolbestanden.

   • Zoekpatroon: het patroon dat wordt gebruikt om de PDB-bestanden te vinden in de map die u hebt aangewezen onder Pad naar de map symbolen.

   • Indexbronnen: geeft aan of bronservergegevens moeten worden ingevoerd in de PDB-bestanden.

   • Symbolen publiceren: geeft aan of de symboolbestanden moeten worden gepubliceerd.

     • Servertype symbool: selecteer Bestandsshare om uw symbolen naar een bestandsshare te publiceren.
     • Pad naar het publiceren van symbolen: de bestandsshare die als host fungeert voor uw symbolen.

   • Uitgebreide logboekregistratie: controleer of u meer informatie in uw logboeken wilt opnemen.

   

YAML

Als u uw symbolen wilt publiceren naar een bestandsshare, voegt u het volgende fragment toe aan uw YAML-pijplijn:

- task: PublishSymbols@2
  inputs:
    SymbolsFolder: '$(Build.SourcesDirectory)'
    SearchPattern: '**/bin/**/*.pdb'
    IndexSources: true
    PublishSymbols: true
    SymbolServerType: 'FileShare' 
    SymbolsPath: '\\server\shareName'

Draagbare PDF-bestanden publiceren naar de symboolserver van Azure Artifacts

Draagbare PDF's zijn symboolbestanden die kunnen worden gemaakt en gebruikt op alle platforms, in tegenstelling tot de traditionele PDBs die alleen in Windows worden gebruikt. Voor draagbare PDF's voert de build de indexering uit, maar u moet nog steeds de taak Indexbronnen en Symbolen publiceren gebruiken om uw symbolen te publiceren.

Bronkoppeling gebruiken in .NET-projecten

Source Link is een set hulpprogramma's waarmee ontwikkelaars fouten in hun broncode kunnen opsporen door de .NET-assembly's terug te koppelen aan de broncode. Bekijk de dotnet/sourcelink GitHub-opslagplaats voor meer informatie over de verschillende pakketten die zijn opgenomen.

• Voor projecten die worden gehost op GitHub, voegt u de Microsoft.SourceLink.GitHub pakketreferentie toe aan uw projectbestand.

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

• Voor projecten die worden gehost op Azure Repos (voormalig Visual Studio Team Services), voegt u de Microsoft.SourceLink.AzureRepos.Git pakketverwijzing toe aan uw projectbestand.

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

• Voor projecten die worden gehost op Azure DevOps Server (voormalig Team Foundation Server), voegt u de Microsoft.SourceLink.AzureDevOpsServer.Git pakketreferentie toe aan uw projectbestand.

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

De publicatietaak instellen

De taak Indexbronnen & Publish Symbols wordt gebruikt om uw broncode te indexeren en uw symbolen te publiceren naar de Server en bestandsshares van Azure Artifacts. Omdat we bronkoppeling gebruiken, moeten we indexering in de publicatietaak uitschakelen.

Klassiek

1. Meld u aan bij uw Azure DevOps-organisatie en navigeer vervolgens naar uw project.

2. Selecteer Pijplijnen, selecteer uw pijplijn en selecteer Vervolgens Bewerken om uw pijplijn te wijzigen.

3. Selecteer in uw pijplijndefinitie of u + een nieuwe taak wilt toevoegen.

4. Zoek naar de indexbronnen en publiceer symbolen . Selecteer Toevoegen om deze toe te voegen aan uw pijplijn.

5. Vul de vereiste velden in en selecteer Symboolserver voor het type Symboolserver. Zorg ervoor dat u indexbronnen uitschakelt om indexering uit te schakelen.

   

YAML

Als u uw draagbare PDBs wilt publiceren naar de symboolserver van Azure Artifacts, voegt u het volgende codefragment toe aan uw YAML-pijplijn:

- task: PublishSymbols@2
  inputs:
    SymbolsFolder: '$(Build.SourcesDirectory)'
    SearchPattern: '**/bin/**/*.pdb'
    IndexSources: false
    PublishSymbols: true
    SymbolServerType: 'TeamServices' 
    SymbolExpirationInDays: '36530'
    IndexableFileFormats: 'Default'
    DetailedLog: true
    SymbolsArtifactName: 'Symbols_$(BuildConfiguration)'

Belangrijk

Als u symbolen wilt verwijderen die zijn gepubliceerd via de taak Indexbronnen en symbolen publiceren, moet u eerst de build verwijderen die deze symbolen heeft gegenereerd. Dit kan worden bereikt met behulp van bewaarbeleid of door de uitvoering handmatig te verwijderen.

Visual Studio instellen

Notitie

Visual Studio voor Mac biedt geen ondersteuning voor foutopsporing met behulp van symboolservers.

Voordat u begint met het gebruik van onze symbolen van de symboolserver van Azure Artifacts, gaan we ervoor zorgen dat Visual Studio correct is ingesteld:

1. Selecteer Extra in Visual Studio en vervolgens Opties.

2. Selecteer Symbolen in het menu Foutopsporing.

3. Selecteer het + teken om een nieuwe locatie voor de symboolserver toe te voegen.

   

4. Er wordt een nieuw dialoogvenster weergegeven, selecteer uw account in de vervolgkeuzelijst en selecteer vervolgens de organisatie waarmee u verbinding wilt maken. Selecteer Verbinding maken wanneer u klaar bent.

5. Selecteer Algemeen in dezelfde sectie voor foutopsporing . Schuif omlaag en schakel ondersteuning voor Source Link inschakelen in om ondersteuning voor draagbare PDBs in te schakelen.

   

Notitie

Als u de optie Bronserver inschakelen inschakelt, kunt u bronserver gebruiken in gevallen waarin de broncode niet lokaal beschikbaar is of het symboolbestand niet overeenkomt met de broncode. Als u foutopsporing wilt inschakelen voor broncode van derden, schakelt u het selectievakje Just My Code inschakelen uit.

Veelgestelde vragen

V: Wat is de duur voor welke symbolen worden bewaard?

A: Een symboolbestand heeft dezelfde bewaarperiode als de build die het heeft gegenereerd. Wanneer u een build handmatig verwijdert of bewaarbeleid gebruikt, worden ook de symbolen die door die build zijn gegenereerd, verwijderd.

V: Kan ik bronindexering gebruiken op een draagbare PDB die is gegenereerd op basis van een .NET Core-assembly?

A: Dit is momenteel niet mogelijk. Bronindexering wordt momenteel niet ondersteund voor draagbare PDBs. De aanbevolen methode is om uw build te configureren om de indexering uit te voeren.

Verwante artikelen:

• Fouten opsporen met Visual Studio.
• Fouten opsporen met WinDbg.
• Bewaarbeleid configureren.