PublishSymbols@2 – Indexkällor och publicera symboler v2-uppgift

Använd den här uppgiften för att indexera källkoden och publicera dina symboler till en filresurs eller Azure Artifacts-symbolserver.

Genom att indexera källkoden kan du använda symbolfilerna för att felsöka ditt program på en annan dator än den som du använde för att skapa ditt program. Du kan till exempel felsöka ett program som skapats av en byggagent från en utvecklingsdator som inte har källkoden.

Med symbolservrar kan felsökaren automatiskt hämta rätt symbolfiler utan att känna till produktnamn, byggnummer eller paketnamn.

# Index sources and publish symbols v2
# Index your source code and publish symbols to a file share or Azure Artifacts symbol server.
- task: PublishSymbols@2
  inputs:
    #SymbolsFolder: '$(Build.SourcesDirectory)' # string. Path to symbols folder. Default: $(Build.SourcesDirectory).
    SearchPattern: '**/bin/**/*.pdb' # string. Required. Search pattern. Default: **/bin/**/*.pdb.
    #Manifest: # string. Manifest. 
    #IndexSources: true # boolean. Index sources. Default: true.
    #PublishSymbols: true # boolean. Publish symbols. Default: true.
    SymbolServerType: # 'TeamServices' | 'FileShare'. Required when PublishSymbols = true. Symbol server type. 
    #SymbolsPath: # string. Optional. Use when PublishSymbols = true && SymbolServerType = FileShare. Path to publish symbols. 
    #CompressSymbols: false # boolean. Optional. Use when SymbolServerType = FileShare. Compress symbols. Default: false.
    #SymbolExpirationInDays: '36530' # string. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol Expiration (in days). Default: 36530.
  # Advanced
    #IndexableFileFormats: 'Default' # 'Default' | 'Pdb' | 'SourceMap' | 'All'. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol file formats to publish. Default: Default.
    #DetailedLog: true # boolean. Verbose logging. Default: true.
    #TreatNotIndexedAsWarning: false # boolean. Warn if not indexed. Default: false.
    #UseNetCoreClientTool: false # boolean. Use NetCore client tool. Default: false.
    #SymbolsMaximumWaitTime: # string. Max wait time (min). 
    #SymbolsProduct: # string. Product. 
    #SymbolsVersion: # string. Version. 
    #SymbolsArtifactName: 'Symbols_$(BuildConfiguration)' # string. Artifact name. Default: Symbols_$(BuildConfiguration).

# Index sources and publish symbols v2
# Index your source code and publish symbols to a file share or Azure Artifacts symbol server.
- task: PublishSymbols@2
  inputs:
    #SymbolsFolder: '$(Build.SourcesDirectory)' # string. Path to symbols folder. Default: $(Build.SourcesDirectory).
    SearchPattern: '**/bin/**/*.pdb' # string. Required. Search pattern. Default: **/bin/**/*.pdb.
    #IndexSources: true # boolean. Index sources. Default: true.
    #PublishSymbols: true # boolean. Publish symbols. Default: true.
    SymbolServerType: # 'TeamServices' | 'FileShare'. Required when PublishSymbols = true. Symbol server type. 
    #SymbolsPath: # string. Optional. Use when PublishSymbols = true && SymbolServerType = FileShare. Path to publish symbols. 
    #CompressSymbols: false # boolean. Optional. Use when SymbolServerType = FileShare. Compress symbols. Default: false.
    #SymbolExpirationInDays: '36530' # string. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol Expiration (in days). Default: 36530.
  # Advanced
    #IndexableFileFormats: 'Default' # 'Default' | 'Pdb' | 'SourceMap' | 'All'. Optional. Use when PublishSymbols = true && SymbolServerType = TeamServices. Symbol file formats to publish. Default: Default.
    #DetailedLog: true # boolean. Verbose logging. Default: true.
    #TreatNotIndexedAsWarning: false # boolean. Warn if not indexed. Default: false.
    #UseNetCoreClientTool: false # boolean. Use NetCore client tool. Default: false.
    #SymbolsMaximumWaitTime: # string. Max wait time (min). 
    #SymbolsProduct: # string. Product. 
    #SymbolsVersion: # string. Version. 
    #SymbolsArtifactName: 'Symbols_$(BuildConfiguration)' # string. Artifact name. Default: Symbols_$(BuildConfiguration).

# Index sources and publish symbols v2
# Index your source code and publish symbols to a file share or Azure Artifacts symbol server.
- task: PublishSymbols@2
  inputs:
    #SymbolsFolder: '$(Build.SourcesDirectory)' # string. Path to symbols folder. Default: $(Build.SourcesDirectory).
    SearchPattern: '**/bin/**/*.pdb' # string. Required. Search pattern. Default: **/bin/**/*.pdb.
    #IndexSources: true # boolean. Index sources. Default: true.
    #PublishSymbols: true # boolean. Publish symbols. Default: true.
    SymbolServerType: # 'TeamServices' | 'FileShare'. Required when PublishSymbols = true. Symbol server type. 
    #SymbolsPath: # string. Optional. Use when PublishSymbols = true && SymbolServerType = FileShare. Path to publish symbols. 
    #CompressSymbols: false # boolean. Optional. Use when SymbolServerType = FileShare. Compress symbols. Default: false.
  # Advanced
    #DetailedLog: true # boolean. Verbose logging. Default: true.
    #TreatNotIndexedAsWarning: false # boolean. Warn if not indexed. Default: false.
    #SymbolsMaximumWaitTime: # string. Max wait time (min). 
    #SymbolsProduct: # string. Product. 
    #SymbolsVersion: # string. Version. 
    #SymbolsArtifactName: 'Symbols_$(BuildConfiguration)' # string. Artifact name. Default: Symbols_$(BuildConfiguration).

SymbolsFolder - sökväg till
string. Standardvärde: $(Build.SourcesDirectory).

Anger sökvägen till den mapp som söks efter med symbolfiler. Standardvärdet är $(Build.SourcesDirectory). Annars anger du en rotad sökväg, till exempel $(Build.BinariesDirectory)/MyProject.

SearchPattern - Sökmönster
string. Obligatoriskt. Standardvärde: **/bin/**/*.pdb.

Anger det mönster som används för att identifiera PDB-filerna som ska publiceras. Mer information finns i referensen för filmatchningsmönster.

Manifest - Manifestera
string.

Sökvägen till en fil som innehåller fler symbolklientnycklar att publicera.

IndexSources - indexkällor
boolean. Standardvärde: true.

Anger om källserverinformation ska matas in i PDB-filerna. Det här alternativet stöds endast på Windows-agenter.

PublishSymbols - Publicera symboler
boolean. Standardvärde: true.

Anger om symbolfilerna ska publiceras.

SymbolServerType - symbolservertyp
string. Krävs när PublishSymbols = true. Tillåtna värden: TeamServices (symbolserver i den här organisationen/samlingen (kräver Azure Artifacts)), FileShare (filresurs).

Anger var du vill publicera symboler. Symboler som publiceras på Azure Artifacts-symbolservern är tillgängliga för alla användare med åtkomst till organisationen/samlingen. Azure DevOps Server stöder endast alternativet File share. Se instruktioner för att Publicera symboler för felsökning av för att använda Symbolserver i Azure Artifacts.

SymbolsPath - sökväg för att publicera symboler
string. Valfritt. Använd när PublishSymbols = true && SymbolServerType = FileShare.

Anger den filresurs som är värd för dina symboler. Det här värdet används i anropet till symstore.exe add som parametern /s. Så här förbereder du SymStore-symbolarkivet:

1. Konfigurera en mapp på en fildelningsserver för att lagra symbolerna. Du kan till exempel konfigurera \fabrikam-share\symbols.
2. Ge fullständig behörighet till build-agentens tjänstkonto.

Om du lämnar det här argumentet tomt kommer dina symboler att vara källindexerade men inte publicerade. Du kan också lagra dina symboler med dina droppar. Se Publicera byggartefakter.

CompressSymbols - Komprimera symboler
boolean. Valfritt. Använd när SymbolServerType = FileShare. Standardvärde: false.

Komprimerar symboler vid publicering till filresurs.

SymbolExpirationInDays - symbolens giltighetstid (i dagar)
string. Valfritt. Använd när PublishSymbols = true && SymbolServerType = TeamServices. Standardvärde: 36530.

Anger hur många dagar som symboler ska behållas.

IndexableFileFormats - symbolfilformat för publicering av
string. Valfritt. Använd när PublishSymbols = true && SymbolServerType = TeamServices. Tillåtna värden: Default (standarduppsättningen med symboler som ska laddas upp), Pdb (Endast Pdb-baserade symboler Windows-pdb och hanterade bärbara pdb-datorer).), SourceMap (Endast JavaScript-baserade SourceMap-symboler (*.js.map)), All (Alla symbolformat som stöds). Standardvärde: Default.

Anger vilka felsökningsformat som ska publiceras på symbolservern.

DetailedLog - utförlig loggning
boolean. Standardvärde: true.

Anger utförlig loggning.

TreatNotIndexedAsWarning - Varna om den inte är indexerad
boolean. Standardvärde: false.

Anger om du vill varna om källor inte indexeras för en PDB-fil. Annars loggas meddelandena som normala utdata.

UseNetCoreClientTool - Använd NetCore-klientverktyget
boolean. Standardvärde: false.

Anger om du vill använda en version av symboluppladdningsverktyget som stöder DWARF- och ELF-filer. Det här alternativet är bara viktigt för Windows-agenter. På icke-Windows-agenter används alltid den version av symboluppladdningsverktyget som stöder DWARF- och ELF-filer.

SymbolsMaximumWaitTime - Maximal väntetid (min)
string.

Anger antalet minuter att vänta innan den här uppgiften misslyckas.

SymbolsProduct - Produkt
string.

Anger produktparametern för att symstore.exe. Standardvärdet är $(Build.DefinitionName).

SymbolsVersion - version
string.

Anger versionsparametern till symstore.exe. Standardvärdet är $(Build.BuildNumber).

SymbolsArtifactName - Artefaktnamn
string. Standardvärde: Symbols_$(BuildConfiguration).

Anger artefaktnamnet som ska användas för symbolartefakten. Detta bör endast användas med servertypen FileShare-symbolserver. Standardvärdet är Symbols_$(BuildConfiguration).

Ingen.