Compartir a través de

Publicación de símbolos con Azure Pipelines

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Con el uso de Azure Pipelines, puede publicar sus símbolos en el servidor de símbolos de Azure Artifacts mediante la tarea Indexar fuentes y publicar símbolos. Puede usar el depurador para conectarse y recuperar automáticamente los archivos de símbolos correctos sin conocer los nombres de producto, los números de compilación o los nombres de paquete. Con Azure Pipelines, también puede publicar los símbolos en archivos compartidos y archivos PDB portátiles.

Nota:

La tarea Indexar fuentes y publicar símbolos no se admite en pipelines de lanzamiento.

Publicación de símbolos en el servidor de símbolos de Azure Artifacts

  1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

  2. Seleccione Canalizaciones, seleccione la canalización y, a continuación, seleccione Editar para modificar la canalización.

  3. En la definición de la canalización, seleccione + para agregar una nueva tarea.

  4. Buscar la tarea Fuentes de índice y publicar símbolos. Seleccione Agregar para agregarlo a la canalización.

  5. Rellene los campos obligatorios de la manera siguiente:

    • Versión de la tarea: 2.\*.

    • Nombre mostrado: nombre mostrado de la tarea.

    • Ruta de acceso a la carpeta de símbolos: ruta de acceso a la carpeta que hospeda los archivos de símbolos.

    • Patrón de búsqueda: el patrón usado para buscar los archivos .pdb en la carpeta que ha designado en Ruta de acceso a la carpeta de símbolos. Se admiten caracteres comodín de carpeta única (*) y caracteres comodín recursivos (**). Ejemplo: *\bin**.pdb: buscará todos los archivos .pdb dentro de todos los subdirectorios denominados bin.

    • Orígenes de índice: indica si se va a insertar información del servidor de origen en los archivos PDB.

    • Publicar símbolos: indica si se van a publicar los archivos de símbolos.

      • Tipo de servidor de símbolos: seleccione Servidor de símbolos en esta organización o colección (requiere Azure Artifacts) para publicar los símbolos en el servidor de símbolos de Azure Artifacts.

    • Registro detallado: incluya más información en sus registros.

Captura de pantalla que muestra cómo configurar los orígenes de índice y publicar la tarea de símbolos para publicar símbolos en el servidor de símbolos de Azure Artifacts.

Publicar símbolos en una carpeta compartida

Además del servidor de símbolos de Azure Artifacts, también puede publicar los símbolos en una compartición de archivos mediante la tarea Indexar Orígenes y Publicar Símbolos.

  1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

  2. Seleccione Canalizaciones, seleccione la canalización y, a continuación, seleccione Editar para modificar la canalización.

  3. En la definición de la canalización, seleccione + para agregar una nueva tarea.

  4. Buscar la tarea Fuentes de índice y publicar símbolos. Seleccione Agregar para agregarlo a la canalización.

  5. Rellene los campos obligatorios de la manera siguiente:

    • Versión de la tarea: 2.\*.

    • Nombre mostrado: nombre mostrado de la tarea.

    • Ruta de acceso a la carpeta de símbolos: ruta de acceso a la carpeta que hospeda los archivos de símbolos.

    • Patrón de búsqueda: el patrón usado para buscar los archivos .pdb en la carpeta que ha designado en Ruta de acceso a la carpeta de símbolos.

    • Orígenes de índice: indica si se va a insertar información del servidor de origen en los archivos PDB.

    • Publicar símbolos: indica si se van a publicar los archivos de símbolos.

      • Tipo de servidor de símbolos: seleccione Recurso compartido de archivos para publicar sus símbolos en un recurso compartido de archivos.
      • Ruta de acceso para publicar símbolos: el recurso compartido de archivos que hospedará los símbolos.

    • Registro detallado: compruebe para incluir más información en los registros.

    Captura de pantalla que muestra cómo configurar los orígenes del índice y la tarea de publicación de símbolos para compartirlos en un archivo.

Publicar archivos PDB portátiles en el servidor de símbolos de Azure Artifacts

Los archivos PDB portátiles son archivos de símbolos que se pueden crear y usar en todas las plataformas, a diferencia de los archivos PDB tradicionales que solo se usan en Windows. Para archivos PDB portátiles, la compilación realiza la indexación, pero aún necesita utilizar la tarea Indexar orígenes y publicar símbolos para publicar los símbolos.

Source Link es un conjunto de herramientas que permiten a los desarrolladores depurar su código fuente a través de la vinculación de los ensamblados de .NET al código fuente. Consulte el repositorio dotnet/sourcelink de GitHub para obtener información sobre los distintos paquetes incluidos.

  • En el caso de los proyectos hospedados en GitHub, agregue la referencia de Microsoft.SourceLink.GitHub paquete al archivo de proyecto.

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

  • En el caso de los proyectos hospedados en Azure Repos (anteriormente Visual Studio Team Services), agregue la referencia de Microsoft.SourceLink.AzureRepos.Git paquete al archivo de proyecto.

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

  • En el caso de los proyectos hospedados en Azure DevOps Server (anteriormente Team Foundation Server), agregue la referencia de Microsoft.SourceLink.AzureDevOpsServer.Git paquete al archivo de proyecto.

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

Configuración de la tarea de publicación

La tarea Index Sources & Publish Symbols se usa para indexar el código fuente y publicar los símbolos en el servidor de símbolos de Azure Artifacts y los recursos compartidos de archivos. Dado que usamos Source Link, tendremos que deshabilitar la indexación en la tarea de publicación.

  1. Inicie sesión en su organización de Azure DevOps y vaya a su proyecto.

  2. Seleccione Canalizaciones, seleccione la canalización y, a continuación, seleccione Editar para modificar la canalización.

  3. En la definición de la canalización, seleccione + para agregar una nueva tarea.

  4. Buscar la tarea Fuentes de índice y publicar símbolos. Seleccione Agregar para agregarlo a la canalización.

  5. Rellene los campos obligatorios y seleccione Servidor de símbolos para el tipo de servidor símbolo. Asegúrese de desactivar Los orígenes de índice para deshabilitar la indexación.

    Captura de pantalla que muestra cómo configurar la tarea de publicación para publicar archivos PDF portátiles en el servidor de símbolos de Azure Artifacts.

Importante

Para eliminar símbolos publicados a través de la tarea Index Sources & Publish Symbols , primero debe eliminar la compilación que generó esos símbolos. Esto se puede lograr mediante directivas de retención o mediante la eliminación manual de la ejecución.

Configuración de Visual Studio

Nota:

Visual Studio para Mac no admite la depuración mediante servidores de símbolos.

Antes de empezar a consumir nuestros símbolos desde el servidor de símbolos de Azure Artifacts, asegúrese de que Visual Studio está configurado correctamente:

  1. En Visual Studio, seleccione Herramientas y , después, Opciones.

  2. Seleccione Símbolos del menú de Depuración.

  3. Seleccione el + signo para agregar una nueva ubicación del servidor de símbolos.

    Captura de pantalla que muestra cómo agregar una nueva ubicación del servidor de símbolos.

  4. Aparecerá un cuadro de diálogo nuevo, seleccione su cuenta en el menú desplegable y, a continuación, seleccione la organización a la que desea conectarse. Seleccione Conectar cuando haya terminado.

  5. Seleccione General de la misma sección Depuración. Desplácese hacia abajo y active Habilitar compatibilidad con Source Link para habilitar la compatibilidad con archivos PDB portátiles.

    Captura de pantalla que muestra cómo habilitar la compatibilidad con vínculos de origen en Visual Studio.

Nota:

Si activa la opción Habilitar compatibilidad con el servidor de origen, puede usar el servidor de origen en los casos en los que el código fuente no está disponible localmente o el archivo de símbolos no coincide con el código fuente. Si desea habilitar la depuración para código fuente de terceros, anule la selección de la casilla Habilitar solo mi código .

Preguntas más frecuentes

P: ¿Cuál es la duración de los símbolos que se conservan?

R: Un archivo de símbolos tiene el mismo período de retención que la compilación que la generó. Al eliminar una compilación manualmente o mediante directivas de retención, también se eliminarán los símbolos generados por esa compilación.

P: ¿Puedo usar la indexación de origen en una PDB portátil generada a partir de un ensamblado de .NET Core?

R: Esto no es posible en este momento. La indexación de origen no se admite actualmente para archivos PDB portátiles. El enfoque recomendado es configurar la compilación para realizar la indexación.

  • Last updated on