Publikowanie symboli za pomocą usługi Azure Pipelines
Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019
Usługa Azure Pipelines umożliwia publikowanie symboli na serwerze symboli usługi Azure Artifacts, wykorzystując zadania „Indeksuj źródła i publikuj symbole” oraz. Możesz użyć debugera, aby nawiązać połączenie i automatycznie pobrać poprawne pliki symboli bez znajomości nazw produktów, numerów kompilacji lub nazw pakietów. Za pomocą usługi Azure Pipelines można również publikować symbole w udostępnieniach plików i przenośnych plikach PDB.
Uwaga
Zadanie polegające na źródłach indeksu i publikowaniu symboli nie jest obsługiwane w potokach wydania.
Publikowanie symboli na serwerze symboli usługi Azure Artifacts
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Pipelines, wybierz potok, a następnie wybierz pozycję Edytuj, aby zmodyfikować potok.
W definicji potoku przetwarzania wybierz pozycję
+, aby dodać nowe zadanie.Wyszukaj źródła indeksu i opublikuj symbole zadania. Wybierz pozycję Dodaj, aby dodać go do potoku.
Wypełnij wymagane pola w następujący sposób:
wersja zadania: 2.\*.
nazwa wyświetlania: nazwa wyświetlana zadania.
ścieżka do folderu symboli: ścieżka do folderu obsługującego pliki symboli.
wzorzec wyszukiwania: wzorzec używany do lokalizowania plików .pdb w folderze wyznaczonym w obszarze ścieżka do folderu symboli. Symbol wieloznaczny dla pojedynczego folderu (
*) i rekursywne symbole wieloznaczne (**) są obsługiwane. Przykład: *\bin**.pdb: wyszuka wszystkie pliki .pdb we wszystkich podkatalogach o nazwie bin.indeks źródeł: wskazuje, czy należy dodać informacje o serwerze źródłowym do plików PDB.
Publikuj symbole: wskazuje, czy opublikować pliki symboli.
- typ serwera symboli: wybierz serwer symboli w tej organizacji/kolekcji (wymaga usługi Azure Artifacts), aby opublikować symbole na serwerze symboli usługi Azure Artifacts.
Rozbudowane rejestrowanie: podaj więcej informacji w swoich dziennikach.
Publikuj symbole na udziale plików
Oprócz serwera symboli usługi Azure Artifacts, można również opublikować symbole do udostępnionego zasobu plikowego za pomocą zadania Index Sources i Publish Symbols.
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz pozycję Pipelines, wybierz swój potok, a następnie wybierz pozycję Edytuj, aby zmodyfikować swój potok.
W definicji potoku przetwarzania wybierz pozycję
+, aby dodać nowe zadanie.Wyszukaj źródła indeksu i opublikuj symbole zadania. Wybierz , a następnie Dodaj, aby dodać je do potoku.
Wypełnij wymagane pola w następujący sposób:
wersja zadania: 2.\*.
nazwa wyświetlana: nazwa wyświetlana zadania.
ścieżka do folderu symboli: ścieżka do folderu obsługującego pliki symboli.
wzorzec wyszukiwania: wzorzec używany do lokalizowania plików .pdb w folderze wyznaczonym w obszarze ścieżka do folderu symboli.
źródła indeksu: wskazuje, czy należy dodać informacje o serwerze źródłowym do plików PDB.
Publikuj symbole: wskazuje, czy opublikować pliki symboli.
- typ serwera symboli: wybierz pozycję udział plików, aby opublikować symbole w udziale plików.
- Ścieżka do publikowania symboli: zasób sieciowy, który będzie przechowywać symbole.
pełne rejestrowanie: sprawdź, czy w dziennikach znajdują się więcej informacji.
Publikowanie przenośnych plików PDB na serwerze symboli usługi Azure Artifacts
Przenośne pliki PDB to pliki symboli, które można tworzyć i używać na wszystkich platformach w przeciwieństwie do tradycyjnych plików PDB, które są używane tylko w systemie Windows. W przypadku przenośnych plików PDB indeksowanie odbywa się podczas kompilacji, ale nadal musisz użyć zadania Index Sources and Publish Symbols, aby opublikować swoje symbole.
Używanie linku źródłowego w projektach platformy .NET
Source Link to zestaw narzędzi, który umożliwia deweloperom debugowanie kodu źródłowego przez mapowanie z zestawów .NET z powrotem do kodu źródłowego. Zapoznaj się z dotnet/sourcelink repozytorium GitHub, aby dowiedzieć się więcej o różnych dołączonych pakietach.
W przypadku projektów hostowanych w usłudze GitHub dodaj odwołanie do pakietu
Microsoft.SourceLink.GitHubdo pliku projektu.<ItemGroup> <PackageReference Include="Microsoft.SourceLink.GitHub" Version="1.1.1" PrivateAssets="All"/> </ItemGroup>W przypadku projektów hostowanych w usłudze Azure Repos (dawniej Visual Studio Team Services) dodaj odwołanie do pakietu
Microsoft.SourceLink.AzureRepos.Gitdo pliku projektu.<ItemGroup> <PackageReference Include="Microsoft.SourceLink.AzureRepos.Git" Version="1.1.1" PrivateAssets="All"/> </ItemGroup>W przypadku projektów hostowanych na serwerze Azure DevOps Server (dawniej Team Foundation Server) dodaj odwołanie do pakietu
Microsoft.SourceLink.AzureDevOpsServer.Gitdo pliku projektu.<ItemGroup> <PackageReference Include="Microsoft.SourceLink.AzureDevOpsServer.Git" Version="1.1.1" PrivateAssets="All"/> </ItemGroup>
Konfigurowanie zadania publikowania
Zadanie Index Sources & Publikowanie symboli służy do indeksowania kodu źródłowego i publikowania symboli na serwerze symboli Azure Artifacts oraz udziałach plików. Ponieważ używamy linku źródłowego, musimy wyłączyć indeksowanie w zadaniu publikowania.
Zaloguj się do organizacji usługi Azure DevOps, a następnie przejdź do projektu.
Wybierz Pipelines, wybierz swój pipeline, a następnie wybierz Edytuj, aby go zmodyfikować.
W definicji potoku przetwarzania wybierz element
+, aby dodać nowe zadanie.Wyszukaj źródła indeksu i opublikuj symbole zadania. Wybierz pozycję Dodaj, aby dodać go do kanału przetwarzania.
Wypełnij wymagane pola i wybierz pozycję Serwer symboli dla typu serwera symboli . Upewnij się, że usunięto zaznaczenie źródła indeksów, aby wyłączyć indeksowanie.
Ważne
Aby usunąć symbole opublikowane przy użyciu zadania Źródła indeksów, & Publikowanie symboli, należy najpierw usunąć kompilację, która wygenerowała te symbole. Można to zrobić przy użyciu zasad przechowywania lub ręcznie usunąć przebieg.
Konfigurowanie programu Visual Studio
Uwaga
Program Visual Studio dla komputerów Mac nie obsługuje debugowania przy użyciu serwerów symboli.
Przed rozpoczęciem korzystania z symboli z serwera symboli usługi Azure Artifacts upewnij się, że program Visual Studio jest prawidłowo skonfigurowany:
W programie Visual Studio wybierz Tools, a następnie Options.
Wybierz Symbole z menu Debugowanie.
Wybierz znak
+, aby dodać nową lokalizację serwera symboli.
Zostanie wyświetlone nowe okno dialogowe, wybierz swoje konto z menu rozwijanego, a następnie wybierz organizację, z którą chcesz nawiązać połączenie. Po zakończeniu wybierz Połącz.
Wybierz pozycję Ogólne w tej samej sekcji Debugowanie. Przewiń w dół i zaznacz „Włącz obsługę linków źródłowych”, aby włączyć obsługę przenośnych plików PDB.
Uwaga
Sprawdzenie opcji Włącz obsługę serwera źródłowego umożliwia użycie Source Server w przypadkach, gdy kod źródłowy jest niedostępny lokalnie lub plik symboli nie jest zgodny z kodem źródłowym. Jeśli chcesz włączyć debugowanie kodu źródłowego innej firmy, usuń zaznaczenie pola wyboru Włącz tylko mój kod .
Często zadawane pytania
.: Jaki jest czas przechowywania symboli?
1: Plik symboli ma ten sam okres przechowywania co kompilacja, która ją wygenerowała. Usunięcie kompilacji ręcznie lub przy użyciu zasad przechowywania spowoduje również usunięcie symboli wygenerowanych przez kompilację.
.: Czy można używać indeksowania źródłowego na przenośnym pliku PDB wygenerowanym na podstawie zestawu platformy .NET Core?
1: Nie jest to możliwe w tej chwili. Indeksowanie źródłowe nie jest obecnie obsługiwane w przypadku przenośnych plików PDB. Zalecaną metodą jest skonfigurowanie kompilacji w celu przeprowadzenia indeksowania.