Compartir vía

Inicio rápido: Introducción a paquetes NuGet en Azure Artifacts

  • Artículo

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

Azure Artifacts permite a los desarrolladores publicar y descargar paquetes NuGet desde orígenes como fuentes y registros públicos. Con Azure Artifacts, puede crear fuentes que sean:

  • Privado, para que pueda compartir paquetes con su equipo y usuarios específicos.
  • Público, para que pueda compartir paquetes abiertamente con cualquier persona de Internet.

En esta guía de inicio rápido, ha aprendido a hacer lo siguiente:

  • Cree una nueva fuente.
  • Configure el proyecto y conéctese a la fuente.
  • Publicar paquetes NuGet.
  • Descargue los paquetes de la fuente.

Requisitos previos

Creación de una fuente

  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.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps Services.

  1. Inicie sesión en el servidor 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.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2022.

  1. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2020.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

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

  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, seleccione la opción Usar paquetes de orígenes públicos a través de esta fuente .

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra las selecciones para crear una nueva fuente en Azure DevOps 2019.

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).

Conexión a una fuente

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

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

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

    Captura de pantalla que muestra el botón para conectarse a una fuente.

  4. Siga las instrucciones de la sección Configuración del proyecto para configurar el archivo nuget.config y autenticarse con Azure Artifacts.

    Captura de pantalla que muestra instrucciones en pantalla para configurar un proyecto.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

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

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

  4. Siga las instrucciones de la sección Configuración del proyecto para conectarse a la fuente.

    Captura de pantalla que muestra instrucciones en pantalla para configurar un proyecto NuGet en Azure DevOps Server 2020 y 2022.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

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

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

  4. Siga las instrucciones para agregar la dirección URL de origen del paquete a nuget.config.

    Captura de pantalla que muestra instrucciones en pantalla para configurar un proyecto NuGet en Azure DevOps Server 2019.

Descarga de paquetes

1. Obtención de la dirección URL del origen del paquete

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

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

  3. Seleccione NuGet en el panel izquierdo y, a continuación, copie el valor de dirección URL de origen del paquete.

  1. Inicie sesión en el servidor de Azure DevOps y vaya al proyecto.

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

  3. Seleccione Visual Studio en el panel izquierdo y copie la dirección URL de origen.

    Captura de pantalla que muestra una dirección URL de origen.

2. Configurar Visual Studio

  1. En Visual Studio, seleccione Herramientas>Opciones.

  2. Expanda la sección Administrador de paquetes NuGet y, a continuación, seleccione Orígenes de paquetes.

  3. Escriba el valor nombre de la fuente y la dirección URL de origen y, a continuación, seleccione el signo más verde (+) para agregar un origen.

  4. Si ha habilitado orígenes ascendentes en la fuente, desactive la casilla nuget.org .

  5. Seleccione Aceptar cuando termine.

    Captura de pantalla que muestra las selecciones para configurar Visual Studio en Windows.

3. Descargar paquetes

  1. En Visual Studio, haga clic con el botón derecho en el proyecto y seleccione Administrar paquetes NuGet.

  2. Seleccione Examinar y, a continuación, seleccione la fuente en el menú desplegable Origen del paquete.

    Captura de pantalla que muestra la selección de un origen de paquete en Visual Studio.

  3. Use la barra de búsqueda para buscar paquetes de la fuente.

Nota:

No se admite el uso del Explorador de paquetes NuGet para buscar paquetes en orígenes ascendentes.

Publicar paquetes

Para publicar el paquete en la fuente, ejecute el siguiente comando. Puede escribir cualquier cadena para el ApiKey argumento.

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.

Contenido relacionado