Uso de paquetes de la Galería de NuGet

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
• Conexión 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 aún no ha creado una fuente, siga los pasos que se indican a continuación para crear uno nuevo y asegúrese de seleccionar la casilla orígenes ascendentes para habilitarlas. Si ya tiene una fuente, continúe con el 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 al proyecto.

2. Seleccione Artefactos y, a continuación, Crear feed.

3. En Nombre, escriba un nombre descriptivo para la fuente.

   En Visibilidad, seleccione una opción para indicar quién puede ver los paquetes dentro de la fuente.

   Si desea incluir paquetes de orígenes públicos, active la casilla en Orígenes ascendentes.

   En Ámbito, especifique si el ámbito de la fuente es el proyecto o la organización.

4. Seleccione Crear cuando haya terminado.

   

Nota:

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

Adición del origen ascendente de la galería de NuGet

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 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 Agregar cuando haya terminado y, a continuación, seleccione Guardar una vez más en la esquina superior derecha para guardar los cambios.

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>
     

Instalación de paquetes desde la Galería de NuGet

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. Consulte Administrar permisos para obtener más detalles.

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.

   

Artículos relacionados

• Publicación de paquetes NuGet con Azure Pipelines
• Publicar paquetes en NuGet.org
• Administración de permisos