Conectar a fuentes de Azure Artifacts (NuGet.exe)

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

Azure Artifacts permite a los desarrolladores publicar y descargar paquetes NuGet de varios orígenes, incluidas fuentes y registros públicos. Puede usar fuentes privadas de Azure Artifacts para compartir paquetes de forma privada con su equipo o usuarios específicos. Además, puede crear fuentes públicas para que los paquetes sean accesibles públicamente, lo que le permite compartirlos abiertamente con cualquier persona de Internet. Este artículo le guiará a través de la conexión a la fuente de Azure Artifacts.

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. Cree una fuente si todavía no tiene una.

• Instale la versión más reciente de NuGet.

• Instale el proveedor de credenciales de Azure Artifacts.

Configuración del proyecto

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 para alimentar y, a continuación, seleccione NuGet.exe en el panel izquierdo.

4. Si esta es la primera vez que usa Azure Artifacts con NuGet.exe, asegúrese de que ha instalado los requisitos previos; de lo contrario, seleccione Obtener las herramientas en la esquina superior derecha para instalarlas.

5. Agregue un archivo nuget.config al proyecto, colóquelo en la misma carpeta que el archivo csproj o sln y, a continuación, pegue el fragmento de código proporcionado en él. El fragmento de código debe estar estructurado de la siguiente manera:

   • 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>
     

   • 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>
     

Importante

El proveedor de credenciales de Azure Artifacts requiere NuGet 4.8.0.5385 o superior.

Para obtener un rendimiento óptimo, Azure Artifacts recomienda usar la versión 5.5.x de NuGet o posterior, ya que incluye correcciones de errores cruciales relacionadas con cancelaciones y tiempos de espera.

Configuración del proyecto heredado

Si usa una versión anterior de NuGet, siga las instrucciones siguientes para conectarse 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 en el menú desplegable.

3. Seleccione Conectar para alimentar y, a continuación, seleccione NuGet.exe en el panel izquierdo.

4. Copie la dirección URL de origen y, a continuación, reemplace por /v3/index.json /v2. La dirección URL de origen actualizada debe ser similar a la siguiente:

   • Fuente con ámbito de proyecto:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

   • Fuente con ámbito de la organización:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

5. Cree un token de acceso personal y asegúrese de limitarlo a la organización adecuada a la que desea acceder y seleccionar uno de los siguientes ámbitos: Empaquetado (lectura), Empaquetado (lectura y escritura) o Empaquetado (lectura, escritura y administración).

6. Ejecute el siguiente comando en una ventana del símbolo del sistema para agregar el origen de fuente al archivo nuget.config :

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. Si su organización está conectada a Microsoft Entra ID, primero debe autenticarse con sus credenciales de AD y, a continuación, agregar el token de acceso personal mediante el comando setapikey :

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>
   
   nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL> 
   

Artículos relacionados

• Publicación y restauración de paquetes NuGet (NuGet.exe)
• Publicación de paquetes NuGet con Azure Pipelines
• Uso de paquetes de NuGet.org