Uso de paquetes de la Galería de NuGet

  • Artículo

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

Con los orígenes ascendentes de Azure Artifacts, los desarrolladores pueden consumir paquetes de registros públicos, como nuget.org y npmjs.com. Este artículo le guiará por el proceso de configuración del proyecto y el uso de la línea de comandos para consumir eficazmente paquetes NuGet desde la Galería de NuGet. En este artículo, aprenderá a:

  • Habilitación de orígenes ascendentes para la fuente
  • Adición de la galería de NuGet como origen ascendente
  • Conectar a la fuente
  • Instalación de paquetes desde nuget.org

Requisitos previos

  • Una organización de Azure DevOps y un proyecto. Cree una organización o un proyecto si aún no lo ha hecho.

  • Una fuente de Azure Artifacts.

  • Descargue NuGet.

  • Descargue e instale el proveedor de credenciales de Azure Artifacts.

Habilitación de orígenes ascendentes en la fuente

Si no tiene una fuente, siga estos pasos para crear uno nuevo y asegúrese de activar la casilla orígenes ascendentes para habilitarlas. Si ya tiene una fuente, puede ir al paso siguiente para agregar la Galería de NuGet como origen ascendente.

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

  2. Seleccione Artefactos y, a continuación, seleccione Crear fuente para crear una nueva fuente.

  3. Escriba un nombre descriptivo para la fuente y defina su visibilidad (que indica quién puede ver los paquetes dentro de la fuente). Especifique el ámbito de la fuente y, si desea incluir paquetes de orígenes públicos, marque la casilla Orígenes ascendentes .

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo crear una fuente de necesidad.

Nota:

De forma predeterminada, las fuentes recién creadas tienen el servicio de compilación de su proyecto establecido en Fuente y Lector ascendente (Colaborador).

Si ha activado la casilla orígenes ascendentes al realizar la fuente, la galería de NuGet debería haberse agregado automáticamente. Si no es así, agréguelo manualmente siguiendo estos pasos:

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

  2. Seleccione Artefactos y, a continuación, seleccione la fuente.

  3. Seleccione el botón Icono de engranaje de icono de engranaje para ir a la configuración de la fuente.

  4. Seleccione Orígenes ascendentes y, a continuación, seleccione Agregar ascendente para agregar un nuevo origen ascendente.

  5. Seleccione Origen público y, a continuación, seleccione Galería de NuGet en el menú desplegable.

  6. Seleccione Guardar cuando haya terminado y, a continuación, seleccione Guardar una vez más en la esquina superior derecha para guardar los cambios.

Nota:

La ubicación del índice de servicio para nuget.org es https://api.nuget.org/v3/index.json.

Conexión a la fuente

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

  2. Seleccione Artefactos y, a continuación, seleccione la fuente.

  3. Seleccione Conectar a la fuente y, a continuación, seleccioneNuGet.exe.

  4. Agregue un archivo nuget.config en la misma carpeta que el archivo .csproj o .sln . Pegue el fragmento de código XML proporcionado en el archivo. Si usa los ejemplos siguientes, asegúrese de reemplazar los marcadores de posición por los valores adecuados para su escenario.

    • Fuente con ámbito de la organización:

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

    • Fuente con ámbito de proyecto:

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

Con nuestro proyecto ahora configurado para autenticarse con nuestra fuente, ahora podemos continuar con la instalación de paquetes desde la Galería de NuGet ascendente. En este ejemplo, instalaremos la biblioteca de registro de diagnóstico de Serilog :

  1. Vaya a la Galería de NuGet en https://www.nuget.org/.

  2. Busque el paquete Serilog y selecciónelo para ir a la página de detalles.

  3. Seleccione la pestaña Administrador de paquetes y copie el comando. En nuestro ejemplo, el comando es el siguiente:

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097

  4. Abra el proyecto en Visual Studio y, a continuación, seleccione Herramientas>NuGet Administrador de paquetes> Administrador de paquetes Consola para abrir la ventana de consola.

  5. Pegue el comando en la ventana consola de Administrador de paquetes y presione Entrar para instalar el paquete.

Nota:

Para guardar paquetes de nivel superior, debe tener el rol Lector de fuente y ascendente (colaborador) o superior. Para más información, consulte Permisos.

Visualización de paquetes guardados

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

  2. Seleccione Artefactos y, a continuación, seleccione la fuente en el menú desplegable.

  3. Seleccione el origen de la galería de NuGet en el menú desplegable para filtrar los paquetes de esta cadena ascendente.

  4. El paquete Serilog , instalado en el paso anterior, ya está disponible en nuestra fuente. Azure Artifacts guardó automáticamente una copia en nuestra fuente cuando ejecutamos el comando de instalación.

    Captura de pantalla que muestra el paquete que se guardó desde la cadena ascendente.