Compartir a través de


Uso de paquetes desde la Galería de NuGet

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

Los orígenes ascendentes de Azure Artifacts facilitan a los desarrolladores extraer paquetes de registros públicos, como nuget.org y npmjs.com. En este artículo, aprenderá a configurar el proyecto y a usar la línea de comandos para consumir paquetes NuGet desde la Galería de NuGet.

Requisitos previos

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

Creación de una fuente y habilitación de orígenes ascendentes

Si aún no ha creado una fuente, siga los pasos que se indican a continuación para crear una nueva fuente y habilitar los orígenes ascendentes. Si ya tiene un feed, 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 a su proyecto.

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

  3. Proporcione un nombre para la fuente, seleccione la opción Visibilidad para definir quién puede ver los paquetes y elija el ámbito. Azure Artifacts recomienda establecer el ámbito de fuentes en un proyecto en lugar de toda la organización.

  4. Asegúrese de comprobar la opción Incluir paquetes de orígenes públicos comunes , ya que lo necesitará para consumir paquetes de registros públicos, como nuget.org, npmjs.com etc.

  5. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo crear una nueva fuente y habilitar orígenes ascendentes en Azure Artifacts.

Si activa la casilla Orígenes ascendentes al crear la fuente (como se muestra en la sección anterior), la Galería de NuGet debería haberse agregado automáticamente a los orígenes ascendentes de la fuente. Si está trabajando con una fuente diferente o olvidó comprobar esa opción, puede agregar manualmente la Galería de NuGet siguiendo estos pasos:

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

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

  3. Seleccione el botón del icono del engranaje icono de engranaje para ir a Configuración de fuente.

  1. Seleccione Orígenes ascendentes y, después, Agregar ascendente.

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

  3. Seleccione Guardar en la esquina superior derecha y, a continuación, seleccione Guardar de nuevo para confirmar y aplicar los cambios.

Conexión a la fuente

En esta sección, aprenderá a configurar el proyecto para autenticarse con la fuente de Azure Artifacts y a guardar paquetes de orígenes ascendentes, como la Galería de NuGet.

  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, seleccioneNuGet.exe.

  4. Asegúrese de que ha instalado los requisitos previos y agregue un archivo nuget.config en la misma carpeta que el archivo .csproj o .sln .

  5. Pegue el fragmento de código XML proporcionado en la sección Configuración del proyecto en el archivo. El archivo debe ser similar al siguiente:

    • 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>
      
    • Feed con ámbito de 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>
      
  1. Inicie sesión en la colecció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 la fuente y, a continuación, seleccione NuGet.exe en el panel de navegación izquierdo.

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

Ahora que el proyecto está configurado para autenticarse con la fuente de Azure Artifacts, puede continuar con la instalación de paquetes desde la galería de NuGet ascendente. En este ejemplo, instalará el SDK de C# de MCP para el Protocolo de contexto de modelo para aplicaciones .NET para interactuar con los servidores y los clientes de MCP:

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

  2. Busque ModelContextProtocol y selecciónelo para abrir la página de detalles.

  3. Seleccione la pestaña CLI de .NET y copie el comando . En este ejemplo, el comando es:

    dotnet add package ModelContextProtocol --version 0.3.0-preview.4
    
  4. Abra una ventana del símbolo del sistema, vaya al directorio del proyecto y pegue el comando y presione Entrar para instalar el paquete.

Una vez instalado, se guardará automáticamente una copia del paquete en la fuente, lo que garantiza la disponibilidad si la Galería de NuGet está inactiva y protege el flujo de trabajo de otros paquetes dañados o malintencionados del registro público.

Nota

Para guardar paquetes de repositorios ascendentes, debe tener el rol de Lector de fuentes y ascendentes (Colaborador) o superior. Consulte Roles y permisos del feed para obtener más detalles.

Visualización de paquetes guardados

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

  2. Seleccione Artefactos y, a continuación, seleccione tu feed 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. Los paquetes ModelContextProtocol , instalados en el paso anterior, ahora están disponibles en nuestra fuente. Azure Artifacts guardó automáticamente una copia en la fuente.

    Captura de pantalla que muestra el paquete MCP guardado en la fuente.