Compartir a través de


Publicación y descarga de paquetes NuGet con Azure Artifacts

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

Azure Artifacts permite a los desarrolladores publicar y descargar paquetes NuGet desde fuentes o registros públicos. Las fuentes pueden ser privadas, lo que permite compartir paquetes con usuarios específicos o públicos, lo que hace que los paquetes sean accesibles para cualquier persona de Internet.

Este artículo le guía a través de la creación de una fuente, la configuración del proyecto y la publicación y descarga de paquetes NuGet.

Requisitos previos

Producto Requisitos
Azure DevOps - Una organización de Azure DevOps .
- Un proyecto de Azure DevOps .
- Descargue e instale el proveedor de credenciales de Azure Artifacts .
- Instale la versión más reciente de NuGet.

Crear una fuente

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

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

  3. Proporcione un Nombre para la fuente, elija la opción Visibilidad que define quién puede ver los paquetes, active Incluir paquetes de orígenes públicos comunes si desea incluir paquetes de orígenes como nuget.org o npmjs.com, y para Ámbito, decida si la fuente debe tener ámbito para el proyecto o toda la organización.

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla de Azure DevOps en la que se muestran selecciones para crear un nuevo feed en Azure DevOps Services.

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

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

  3. Proporcione un Nombre para la fuente, elija la opción Visibilidad que define quién puede ver los paquetes, active Incluir paquetes de orígenes públicos comunes si desea incluir paquetes de orígenes como nuget.org o npmjs.com, y para Ámbito, decida si la fuente debe tener ámbito para el proyecto o toda la organización.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla en la que se muestran selecciones para crear un nuevo feed en Azure DevOps 2022.

Nota

De forma predeterminada, el servicio de compilación del proyecto (por ejemplo: projectName Build Service (orgName)) tiene asignado el rol Lector de fuente y lector ascendente (colaborador) cuando se crea una nueva fuente.

Conexión a una 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 en el menú desplegable.

  3. Seleccione Conectar a la fuente y, a continuación, seleccione NuGet.exe en el panel de navegación izquierdo. Si esta es la primera vez que usa Azure Artifacts con Nuget.exe, asegúrese de que ha instalado los requisitos previos.

  4. Siga las instrucciones proporcionadas en la sección Configuración del proyecto para configurar el archivo nuget.config y conectarse a la fuente de Azure Artifacts.

    Captura de pantalla que muestra cómo configurar el proyecto y conectarse a la fuente en Azure DevOps Services.

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

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

  3. Seleccione Conectar a la fuente y, a continuación, seleccione NuGet.exe en el panel de navegación izquierdo.

  4. Siga las instrucciones proporcionadas en la sección Configuración del proyecto para configurar el archivo nuget.config y conectarse a la fuente de Azure Artifacts.

    Captura de pantalla que muestra cómo configurar el proyecto y conectarse a la fuente en Azure DevOps Server 2020 y 2022.

Publicación de paquetes en la fuente

Para publicar un paquete a su feed, simplemente ejecute el siguiente comando. El ApiKey parámetro es necesario, pero puede usar cualquier cadena arbitraria como su valor.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Ejemplos

  • Fuente con ámbito de proyecto:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    
  • Feed con ámbito de organización:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    

Nota

ApiKey es necesario, pero puede usar cualquier valor arbitrario al publicar en fuentes de Azure Artifacts.

Descarga paquetes desde tu feed

Para restaurar paquetes de su fuente ejecute el siguiente comando en el directorio del proyecto:

nuget.exe restore

Nota

No se admite la búsqueda de paquetes en orígenes ascendentes mediante el Explorador de paquetes NuGet.