Publikování symbolů pomocí Azure Pipelines

  • Článek

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

Pomocí Služby Azure Pipelines můžete symboly publikovat na serveru symbolů Azure Artifacts pomocí zdrojů indexů a publikovat úlohu symbolů . Ladicí program můžete použít k připojení a automatickému načtení správných souborů symbolů bez znalosti názvů produktů, čísel buildů nebo názvů balíčků. Pomocí Azure Pipelines můžete také publikovat symboly do sdílených složek a přenosných souborů PDB.

Poznámka:

Úloha zdroje indexu a publikování symbolů není v kanálech verzí podporovaná.

Publikování symbolů na server symbolů Azure Artifacts

  1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

  2. Vyberte Kanály, vyberte kanál a pak vyberte Upravit a upravte kanál.

  3. V definici kanálu vyberte + , že chcete přidat novou úlohu.

  4. Vyhledejte úlohu Zdroje indexu a publikujte symboly . Vyberte Přidat a přidejte ho do kanálu.

  5. Vyplňte požadovaná pole následujícím způsobem:

    • Verze úlohy: 2.\*.

    • Zobrazovaný název: zobrazovaný název úkolu.

    • Cesta ke složce symbolů: cesta ke složce, která je hostitelem souborů symbolů.

    • Vzor hledání: Vzor použitý k vyhledání souborů .pdb ve složce, kterou jste určili ve složce Cesta k symbolům. Podporují se zástupné kóty s jednou složkou (*) a rekurzivní zástupné cardy (**). Příklad: *\bin**.pdb: vyhledá všechny soubory .pdb ve všech podadresářích s názvem bin.

    • Zdroje indexu: Označuje, zda se mají do souborů PDB vkládat informace o zdrojovém serveru.

    • Symboly publikování: označuje, jestli se mají soubory symbolů publikovat.

      • Typ serveru symbolů: Vyberte Server symbolů v této organizaci nebo kolekci (vyžaduje Azure Artifacts) a publikujte symboly na server symbolů Azure Artifacts.

    • Podrobné protokolování: Do protokolů uveďte další informace.

Snímek obrazovky znázorňující, jak nakonfigurovat zdroje indexů a publikovat úlohu symbolů pro publikování symbolů na server symbolů Azure Artifacts

Publikování symbolů do sdílené složky

Kromě serveru symbolů Azure Artifacts můžete symboly publikovat také do sdílené složky pomocí úlohy Zdroje indexu a Publikovat symboly .

  1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

  2. Vyberte Kanály, vyberte kanál a pak vyberte Upravit a upravte kanál.

  3. V definici kanálu vyberte + , že chcete přidat novou úlohu.

  4. Vyhledejte úlohu Zdroje indexu a publikujte symboly . Vyberte Přidat a přidejte ho do kanálu.

  5. Vyplňte požadovaná pole následujícím způsobem:

    • Verze úlohy: 2.\*.

    • Zobrazovaný název: zobrazovaný název úkolu.

    • Cesta ke složce symbolů: cesta ke složce, která je hostitelem souborů symbolů.

    • Vzor hledání: Vzor použitý k vyhledání souborů .pdb ve složce, kterou jste určili ve složce Cesta k symbolům.

    • Zdroje indexu: Označuje, zda se mají do souborů PDB vkládat informace o zdrojovém serveru.

    • Symboly publikování: označuje, jestli se mají soubory symbolů publikovat.

      • Typ serveru symbolů: Vyberte sdílenou složku a publikujte symboly do sdílené složky.
      • Cesta k publikování symbolů: sdílená složka, která bude hostovat vaše symboly.

    • Podrobné protokolování: Zkontrolujte, jestli chcete do protokolů zahrnout další informace.

    Snímek obrazovky znázorňující, jak nakonfigurovat zdroje indexů a publikovat úlohu symbolů pro publikování symbolů do sdílené složky

Publikování přenosných souborů PDB na server symbolů Azure Artifacts

Přenosné soubory PDB jsou soubory symbolů, které lze vytvářet a používat na všech platformách na rozdíl od tradičních souborů PDB, které se používají pouze ve Windows. U přenosných souborů PDB sestavení indexuje, ale k publikování symbolů stále potřebujete použít úlohu Zdroje indexu a Publikovat symboly .

Zdrojový odkaz je sada nástrojů, které vývojářům umožňují ladit zdrojový kód mapováním ze sestavení .NET zpět na zdrojový kód. Informace o různých balíčcích, které jsou součástí, najdete v úložišti GitHubu dotnet/sourcelink .

  • U projektů hostovaných na GitHubu přidejte odkaz na Microsoft.SourceLink.GitHub balíček do souboru projektu.

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

  • Pro projekty hostované v Azure Repos (dříve Visual Studio Team Services) přidejte odkaz na Microsoft.SourceLink.AzureRepos.Git balíček do souboru projektu.

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

  • Pro projekty hostované na Azure DevOps Serveru (dříve Team Foundation Server) přidejte Microsoft.SourceLink.AzureDevOpsServer.Git odkaz na balíček do souboru projektu.

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

Nastavení úlohy publikování

Úloha Zdroje indexu a publikování symbolů slouží k indexování zdrojového kódu a publikování symbolů na server a sdílené složky Azure Artifacts. Vzhledem k tomu, že používáme odkaz na zdroj, budeme muset zakázat indexování v úloze publikování.

  1. Přihlaste se ke své organizaci Azure DevOps a přejděte k projektu.

  2. Vyberte Kanály, vyberte kanál a pak vyberte Upravit a upravte kanál.

  3. V definici kanálu vyberte + , že chcete přidat novou úlohu.

  4. Vyhledejte úlohu Zdroje indexu a publikujte symboly . Vyberte Přidat a přidejte ho do kanálu.

  5. Vyplňte požadovaná pole a jako typ serveru symbolu vyberte Server symbolů. Pokud chcete indexování zakázat, nezapomeňte zrušit zaškrtnutí políčka Zdroje indexů.

    Snímek obrazovky znázorňující, jak nakonfigurovat úlohu publikování pro publikování přenosných souborů PDB na server symbolů Azure Artifacts

Důležité

Pokud chcete odstranit symboly publikované prostřednictvím úlohy Zdroje indexů a publikovat symboly , musíte nejprve odstranit sestavení, které tyto symboly vygenerovalo. Toho lze dosáhnout pomocí zásad uchovávání informací nebo ručním odstraněním spuštění.

Nastavit Visual Studio

Poznámka:

Visual Studio pro Mac nepodporuje ladění pomocí serverů symbolů.

Než začneme využívat symboly ze serveru symbolů Azure Artifacts, ujistěme se, že je sada Visual Studio správně nastavená:

  1. V sadě Visual Studio vyberte Nástroje a potom Možnosti.

  2. V nabídce Ladění vyberte symboly.

  3. + Výběrem znaménka přidejte nové umístění serveru symbolů.

    Snímek obrazovky znázorňující, jak přidat nové umístění serveru symbolů

  4. Zobrazí se nové dialogové okno, v rozevírací nabídce vyberte svůj účet a pak vyberte organizaci, ke které se chcete připojit. Až budete hotovi, vyberte Připojení.

  5. Ve stejné části Ladění vyberte Obecné. Posuňte se dolů a zaškrtněte možnost Povolit podporu zdrojového odkazu a povolte podporu přenosných souborů PDB.

    Snímek obrazovky znázorňující, jak povolit podporu zdrojových odkazů v sadě Visual Studio

Poznámka:

Kontrola možnosti Povolit podporu zdrojového serveru umožňuje použít zdrojový server v případech, kdy zdrojový kód není k dispozici místně nebo soubor symbolů neodpovídá zdrojovému kódu. Pokud chcete povolit ladění zdrojového kódu třetí strany, zrušte zaškrtnutí políčka Povolit pouze můj kód .

Nejčastější dotazy

Otázka: Jaká je doba trvání, po kterou jsou symboly zachovány?

A: Soubor symbolů má stejnou dobu uchovávání jako sestavení, které ho vygenerovalo. Když sestavení odstraníte ručně nebo pomocí zásad uchovávání informací, odstraní se také symboly vygenerované tímto sestavením.

Otázka: Můžu použít zdrojové indexování na přenosném souboru PDB vygenerovaném ze sestavení .NET Core?

A: V tuto chvíli to není možné. U přenosných souborů PDB se v současné době nepodporuje indexování zdrojového kódu. Doporučeným přístupem je nakonfigurovat sestavení tak, aby indexování dělalo.