Szimbólumok közzététele az Azure Pipelines használatával

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Az Azure Pipelines használatával a szimbólumokat közzéteheti az Azure Artifacts szimbólumkiszolgálón az Index-források használatával, és közzéteheti a szimbólumokat . A hibakeresővel a megfelelő szimbólumfájlokat csatlakoztathatja és automatikusan lekérheti anélkül, hogy ismerné a termékneveket, a buildszámokat vagy a csomagneveket. Az Azure Pipelines használatával a szimbólumokat fájlmegosztásokban és hordozható PDF-fájlokban is közzéteheti.

Feljegyzés

A kiadási folyamatok nem támogatják az indexforrásokat és a szimbólumok közzétételét.

Szimbólumok közzététele az Azure Artifacts szimbólumkiszolgálón

Klasszikus

1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

2. Válassza a Folyamatok lehetőséget, válassza ki a folyamatot, majd válassza a Szerkesztés lehetőséget a folyamat módosításához.

3. A folyamatdefinícióban válassza ki + az új feladat hozzáadását.

4. Keresse meg az indexforrásokat, és tegye közzé a szimbólumokat . Válassza a Hozzáadás lehetőséget a folyamathoz való hozzáadásához.

5. Töltse ki a szükséges mezőket az alábbiak szerint:

   • Feladat verziója: 2.\*.

   • Megjelenítendő név: feladatmegjelenítés neve.

   • A szimbólumok mappa elérési útja: a szimbólumfájlokat tartalmazó mappa elérési útja.

   • Keresési minta: a .pdb fájlok megkeresésére használt minta a Path to symbols mappában kijelölt mappában. Az egymappás helyettesítő karakterek (*) és a rekurzív helyettesítő karakterek (**) egyaránt támogatottak. Példa: *\bin**.pdb: minden .pdb fájlt keres az összes bin nevű alkönyvtárban.

   • Indexforrások: azt jelzi, hogy a forráskiszolgáló adatait be kell-e szúrni a PDB-fájlokba.

   • Szimbólumok közzététele: azt jelzi, hogy közzé kívánja-e tenni a szimbólumfájlokat.

     • Szimbólumkiszolgáló típusa: válassza a szimbólumkiszolgálót ebben a szervezetben/gyűjteményben (az Azure Artifacts szükséges) a szimbólumok Azure Artifacts szimbólumkiszolgálón való közzétételéhez.

   • Részletes naplózás: további információk belefoglalása a naplókba.

YAML

Ha közzé szeretné tenni a szimbólumokat az Azure Artifacts szimbólumkiszolgálón, adja hozzá a következő kódrészletet a YAML-folyamathoz:

- 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)'

Szimbólumok közzététele fájlmegosztásban

Az Azure Artifacts szimbólumkiszolgálón kívül a szimbólumokat egy fájlmegosztásban is közzéteheti az Indexforrások és a Szimbólumok közzététele feladattal.

Klasszikus

1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

2. Válassza a Folyamatok lehetőséget, válassza ki a folyamatot, majd válassza a Szerkesztés lehetőséget a folyamat módosításához.

3. A folyamatdefinícióban válassza ki + az új feladat hozzáadását.

4. Keresse meg az indexforrásokat, és tegye közzé a szimbólumokat . Válassza a Hozzáadás lehetőséget a folyamathoz való hozzáadásához.

5. Töltse ki a szükséges mezőket az alábbiak szerint:

   • Feladat verziója: 2.\*.

   • Megjelenítendő név: feladatmegjelenítés neve.

   • A szimbólumok mappa elérési útja: a szimbólumfájlokat tartalmazó mappa elérési útja.

   • Keresési minta: a .pdb fájlok megkeresésére használt minta a Path to symbols mappában kijelölt mappában.

   • Indexforrások: azt jelzi, hogy a forráskiszolgáló adatait be kell-e szúrni a PDB-fájlokba.

   • Szimbólumok közzététele: azt jelzi, hogy közzé kívánja-e tenni a szimbólumfájlokat.

     • Szimbólumkiszolgáló típusa: Válassza a Fájlmegosztás lehetőséget a szimbólumok fájlmegosztásban való közzétételéhez.
     • Szimbólumok közzétételének elérési útja: a szimbólumokat tartalmazó fájlmegosztás.

   • Részletes naplózás: ellenőrizze, hogy további információkat szeretne-e szerepeltetni a naplókban.

   

YAML

A szimbólumok fájlmegosztásban való közzétételéhez adja hozzá a következő kódrészletet a YAML-folyamathoz:

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

Hordozható PDF-ek közzététele az Azure Artifacts szimbólumkiszolgálón

A hordozható PDF-fájlok olyan szimbólumfájlok, amelyek minden platformon létrehozhatók és használhatók, ellentétben a hagyományos PDF-ekkel, amelyeket csak Windows rendszeren használnak. Hordozható PDF-fájlok esetén a build végzi az indexelést, de a szimbólumok közzétételéhez továbbra is az Indexforrások és a Szimbólumok közzététele feladatot kell használnia.

Forráshivatkozás használata .NET-projektekben

A Source Link olyan eszközök készlete, amelyek lehetővé teszik a fejlesztők számára a forráskód hibakeresését a .NET-szerelvényekről a forráskódra való leképezéssel. Tekintse meg a dotnet/sourcelink GitHub-adattárat, és ismerje meg a különböző csomagokat.

• A GitHubon üzemeltetett projektek esetében adja hozzá a Microsoft.SourceLink.GitHub csomaghivatkozást a projektfájlhoz.

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

• Az Azure Reposban (korábbi Visual Studio Team Services) üzemeltetett projektek esetében adja hozzá a Microsoft.SourceLink.AzureRepos.Git csomaghivatkozást a projektfájlhoz.

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

• Az Azure DevOps Serveren (korábbi Team Foundation Server) üzemeltetett projektek esetében adja hozzá a Microsoft.SourceLink.AzureDevOpsServer.Git csomaghivatkozást a projektfájlhoz.

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

A közzétételi feladat beállítása

Az Indexforrások > Szimbólumok közzététele feladat a forráskód indexelésére és a szimbólumok Azure Artifacts-szimbólumok kiszolgálói és fájlmegosztásokban való közzétételére szolgál. Mivel a Forráshivatkozást használjuk, le kell tiltanunk az indexelést a közzétételi feladatban.

Klasszikus

1. Jelentkezzen be az Azure DevOps-szervezetbe, és lépjen a projekthez.

2. Válassza a Folyamatok lehetőséget, válassza ki a folyamatot, majd válassza a Szerkesztés lehetőséget a folyamat módosításához.

3. A folyamatdefinícióban válassza ki + az új feladat hozzáadását.

4. Keresse meg az indexforrásokat, és tegye közzé a szimbólumokat . Válassza a Hozzáadás lehetőséget a folyamathoz való hozzáadásához.

5. Töltse ki a szükséges mezőket, és válassza a Szimbólumkiszolgáló lehetőséget a szimbólumkiszolgáló típusához. Az indexelés letiltásához törölje az Indexforrások jelölőnégyzet jelölését.

   

YAML

Ha közzé szeretné tenni a hordozható PDF-fájlokat az Azure Artifacts szimbólumkiszolgálón, adja hozzá a következő kódrészletet a YAML-folyamathoz:

- 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)'

Fontos

Az Indexforrások > Szimbólumok közzététele feladaton keresztül közzétett szimbólumok törléséhez először törölnie kell a szimbólumokat létrehozó buildet. Ez megőrzési szabályzatok használatával vagy a futtatás manuális törlésével valósítható meg.

A Visual Studio telepítése

Feljegyzés

A Visual Studio for Mac nem támogatja a szimbólumkiszolgálók használatával végzett hibakeresést.

Mielőtt elkezdené használni szimbólumainkat az Azure Artifacts szimbólumkiszolgálóról, győződjön meg arról, hogy a Visual Studio megfelelően van beállítva:

1. A Visual Studióban válassza az Eszközök , majd a Beállítások lehetőséget.

2. Válassza a Szimbólumok lehetőséget a Hibakeresés menüben.

3. Válassza ki a + jelet egy új szimbólumkiszolgáló helyének hozzáadásához.

   

4. Megjelenik egy új párbeszédpanel, válassza ki a fiókját a legördülő menüből, majd válassza ki azt a szervezetet, amelyhez csatlakozni szeretne. Ha végzett, válassza Csatlakozás.

5. Válassza az Általános lehetőséget ugyanabból a hibakeresési szakaszból. Görgessen le, és jelölje be a Forráshivatkozás engedélyezése támogatást a hordozható PDF-fájlok támogatásának engedélyezéséhez.

   

Feljegyzés

A forráskiszolgáló támogatásának engedélyezése beállítás ellenőrzése lehetővé teszi a forráskiszolgáló használatát olyan esetekben, amikor a forráskód nem érhető el helyileg, vagy ha a szimbólumfájl nem egyezik a forráskóddal. Ha engedélyezni szeretné a külső forráskód hibakeresését, törölje a jelölést a Csak saját kód engedélyezése jelölőnégyzetből.

GYIK

K: Mennyi ideig őrzik meg a szimbólumokat?

Válasz: A szimbólumfájlok megőrzési ideje megegyezik az azt létrehozó buildel. Ha manuálisan vagy adatmegőrzési házirendek használatával töröl egy buildet, a build által létrehozott szimbólumok is törlődnek.

K: Használhatok forrásindexelést egy .NET Core-szerelvényből létrehozott hordozható PDB-n?

Válasz: Ez jelenleg nem lehetséges. A forrásindexelés jelenleg nem támogatott a hordozható PDF-fájlok esetében. Az ajánlott módszer az, hogy a buildet az indexeléshez konfigurálja.

Kapcsolódó cikkek

• Hibakeresés a Visual Studióval.
• Hibakeresés a WinDbg használatával.
• Adatmegőrzési szabályzatok konfigurálása.