Uso de orígenes ascendentes en una fuente pública

servicios de Azure DevOps

Azure Artifacts le ayuda a administrar todas las dependencias desde una sola fuente. Al configurar fuentes de origen, puede consumir paquetes de consumo de repositorios y registros públicos como NuGet.org, and npmjs.com. En este artículo se le explica cómo configurar fuentes de origen en un repositorio público y restaurar sus paquetes.

Importante

Los canales públicos dependen de los proyectos públicos. A partir de 2027, los proyectos públicos existentes se convertirán automáticamente en privados. Cuando eso sucede, los canales públicos dejan de ser accesibles públicamente porque heredan la visibilidad del proyecto que los hospeda. Planee cualquier distribución continua de paquetes públicos y estrategia ascendente antes de 2027. Para obtener más información, consulte Retirada de proyectos públicos.

Requisitos previos

Producto Requisitos
Azure DevOps - Una organización de Azure DevOps .
- Un proyecto de Azure DevOps .
- Un proyecto público existente. Los proyectos públicos se retiran y esta característica solo se aplica a los proyectos que permanecen públicos hasta la conversión automática de 2027 a privado.

Crear una fuente pública

Importante

Solo las organizaciones con la directiva Permitir proyecto público ya habilitada pueden crear proyectos o cambiar la visibilidad de un proyecto a público. La directiva ya no está disponible para las organizaciones que aún no lo usan. Microsoft recomienda usar GitHub para todas las necesidades del proyecto público.

Una fuente pública es una fuente con ámbito de proyecto en un proyecto público existente. Las fuentes públicas heredan la configuración de visibilidad del proyecto de hospedaje. Si ya tiene una fuente pública, puede ir directamente a la sección siguiente. De lo contrario, si todavía tiene un proyecto público existente, cree uno de los siguientes modos:

  1. Inicie sesión en Azure DevOps y vaya al proyecto público existente.

  2. Seleccione Artefactos y, después, Crear Feed.

  3. Proporcione un nombre para la fuente y elija Proyecto: YourProjectName (Recomendado) como Ámbito.

  4. Seleccione Crear cuando haya terminado.

    Captura de pantalla que muestra cómo crear una nueva fuente pública en Azure Artifacts.

Importante

Los repositorios públicos no admiten usar fuentes de origen en repositorios de artefactos privados. Solo se pueden usar repositorios públicos como fuentes de origen u otros repositorios de Azure Artifacts públicos.

Adición de un origen ascendente

Cuando tenga configurado el repositorio público, podrá empezar a añadir fuentes de origen. En el caso de las fuentes públicas, solo puede configurar registros públicos u otras fuentes públicas de Azure Artifacts como orígenes ascendentes. Siga estos pasos para agregar un origen ascendente:

  1. Inicie sesión en Azure DevOps y vaya al proyecto público existente.

  2. Seleccione Elementos y luego seleccione su fuente pública desde el menú desplegable.

  3. Seleccione el icono de engranaje para abrir la configuración del feed.

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

  5. Seleccione el tipo de origen ascendente. En este ejemplo, agregará NuGet.org como origen ascendente, por lo que seleccione Origen público.

  6. Seleccione la Galería de NuGet en el menú desplegable y, a continuación, seleccione Agregar.

  7. Seleccione Guardar a la derecha para guardar el nuevo origen ascendente.

Importante

Los archivos de bloqueo de paquetes son necesarios para guardar paquetes de NuGet y .NET desde fuentes ascendentes en un feed público.

Restaurar paquetes

Ejecute el siguiente comando en el directorio del proyecto para restaurar los paquetes:

Nota:

Debe tener el permiso Lector de repositorios y fuentes de origen (Colaborador) o superior para instalar nuevas versiones de paquetes a partir de fuentes de origen. Los usuarios anónimos solo pueden instalar paquetes que ya existan en el repositorio.

nuget.exe restore

Preguntas y respuestas

P: Estoy intentando restaurar mis paquetes, pero obtengo un error 401 no autorizado. ¿Por qué?

El contenido de una fuente solo se puede cambiar mediante una identidad autenticada y autorizada con los permisos adecuados. Esto incluye guardar paquetes de una fuente de origen externa.

  • Los usuarios anónimos pueden descargar paquetes ya guardados en un feed, pero no pueden guardar nuevos paquetes de fuentes ascendentes.

  • Los mantenedores de proyectos deben asegurarse de que todas las versiones de paquete necesarias se guardan en la fuente pública. Esto se puede hacer si se restaura el proyecto mediante una identidad que incluya unas credenciales cuando se le pidan y tenga el permiso Lector de repositorios y fuentes de origen (Colaborador) o superior.

Si los usuarios anónimos encuentran repetidamente mensajes de credenciales (errores 401), pruebe estos enfoques:

  • Evite usar intervalos de versión del paquete en la configuración del proyecto. Especifique versiones de paquete explícitas para asegurarse de que los clientes solo soliciten la versión exacta necesaria.

  • Use archivos de bloqueo (si se admiten) para que los clientes de paquetes solo soliciten las versiones exactas necesarias durante las operaciones de restauración o instalación.

P: Estoy restaurando paquetes en Visual Studio, pero proceden de otro origen. ¿Por qué?

R: Asegúrese de que Visual Studio usa el origen especificado en el archivo nuget.config, no el administrador de paquetes NuGet local. Consulte Orígenes de paquetes para obtener más detalles.

También puede usar la CLI de NuGet para forzar a NuGet a usar el origen en el archivo de configuración ejecutando el siguiente comando:

nuget restore -config <PATH_TO_NUGET_CONFIG_FILE>