Procedimientos recomendados de Azure Artifacts

Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts ofrece a los equipos un lugar para publicar, almacenar, compartir y consumir paquetes. A medida que crece el número de fuentes, paquetes y consumidores, algunas decisiones tempranas pueden hacer que la administración de paquetes sea sencilla o más difícil de mantener. En este artículo se recopilan las prácticas que le ayudan a mantener predecibles las restauraciones de paquetes, publicar paquetes con mayor control y administrar los orígenes más fácilmente con el tiempo.

Guía básica

• Utilice una fuente en cada archivo de configuración del cliente y habilite los orígenes ascendentes en esa fuente cuando también necesite registros públicos u orígenes internos adicionales. Este enfoque simplifica los archivos de configuración y ayuda a la fuente a proporcionar un comportamiento de restauración más predecible. Para obtener más información, consulte ¿Qué son los orígenes ascendentes?

• Considere las vistas de feed como canales de distribución. Publique nuevas versiones en @local, valide allí y, a continuación, promueva las versiones que están listas para su uso más amplio en @prerelease o @release. Este enfoque le ayuda a separar las versiones de paquete que se siguen evaluando a partir de las versiones que están listas para compartir con más consumidores. Para obtener más información, consulte ¿Qué son las vistas de fuente?

• Configurar los permisos de fuente deliberadamente. Decida quién puede publicar paquetes, quién puede guardar paquetes procedentes de fuentes ascendentes y quién puede consumir paquetes desde vistas compartidas. Los límites claros entre roles ayudan a proteger el canal y a reducir los cambios accidentales. Para obtener más información, consulte Roles y permisos de fuente.

• Habilite las directivas de retención antes de que comiencen a acumularse las versiones anteriores del paquete. Las versiones anteriores pueden acumularse rápidamente, especialmente en canales activos. Las directivas de retención ayudan a controlar el crecimiento del almacenamiento y a reducir el esfuerzo necesario para mantener las fuentes manejables. Para obtener más información, consulte Eliminación automática de paquetes con directivas de retención.

Procedimientos recomendados para editores de paquetes

Los procedimientos recomendados siguientes ayudan a garantizar la coherencia, la seguridad y una experiencia de usuario fluida. A continuación se muestran recomendaciones clave al publicar paquetes con Azure Artifacts:

• Use una sola fuente por repositorio:

  Una fuente es una construcción organizativa que puede hospedar varios tipos de paquete. Aunque un proyecto puede usar varias fuentes, normalmente es mejor mantener un repositorio conectado a una fuente principal para reducir los conflictos y simplificar la administración de paquetes. Si necesita paquetes de canales adicionales o de repositorios públicos, use orígenes ascendentes en lugar de añadir varias fuentes directamente a la configuración de cada cliente.

• Publicar automáticamente paquetes recién creados:

  La automatización de la publicación de nuevos paquetes ayuda a garantizar que las versiones más recientes estén disponibles para el equipo o los consumidores de destino sin intervención manual. Al publicar un paquete, Azure Artifacts lo agrega a la vista @local de la fuente de paquetes. Consulte ¿Qué son las vistas de fuente? para obtener más detalles.

• Habilite las directivas de retención para limpiar automáticamente las versiones anteriores del paquete:

  Con el tiempo, las versiones anteriores del paquete pueden acumularse, consumir almacenamiento y hacer que las fuentes sean más difíciles de administrar. Las directivas de retención permiten quitar automáticamente las versiones anteriores del paquete mientras mantiene un número especificado de versiones recientes. Este proceso ayuda a controlar el crecimiento del almacenamiento y a mantener las fuentes más fáciles de mantener. Consulte Eliminación automática de paquetes con directivas de retención para obtener más detalles.

• Utiliza las vistas del feed para publicar paquetes:

  Las vistas de fuente permiten compartir un subconjunto de versiones de paquete con consumidores. Por ejemplo, puede promover un paquete a @prerelease para los usuarios pioneros y, a continuación, promoverlo a @release cuando esté listo para su uso más amplio. Los paquetes promocionados a una vista están exentos de las directivas de retención. Consulte ¿Qué son las vistas de fuente? para obtener más detalles.

• Asegúrese de tener los permisos de acceso adecuados para sus vistas:

  Si sus paquetes son utilizados por equipos externos o entre distintas organizaciones, asegúrese de que las vistas @release y @prerelease tengan la configuración de visibilidad adecuada. Consulte Configuración de vistas de feed para obtener más detalles.

Procedimientos recomendados para consumidores de paquetes

Al consumir paquetes, procura que la restauración sea predecible y deja claro de dónde proceden los paquetes.

• Use una fuente en la configuración del cliente:

  Para que su feed pueda ofrecer una restauración determinista, asegúrese de que la configuración del cliente haga referencia a un único feed con orígenes upstream habilitados. Este enfoque simplifica los archivos de configuración y reduce la posibilidad de resultados inesperados de resolución de paquetes. Para obtener más información, consulte ¿Qué son los orígenes ascendentes?

• Utilizar fuentes originales para paquetes externos:

  Si usa paquetes de fuentes externas o registros públicos, como NuGet.org o npmjs.com, use orígenes ascendentes en lugar de agregar esos orígenes por separado a cada configuración de cliente. Este enfoque proporciona a su equipo una manera coherente de restaurar las dependencias internas y externas a través de la misma fuente. Para obtener más información, consulte ¿Qué son los orígenes ascendentes? y Configuración de orígenes ascendentes.

  Nota:

  Debe ser un lector de fuente y ascendente (colaborador) o superior para guardar paquetes de orígenes ascendentes. Consulte Roles y permisos de fuente para obtener más detalles.

• Ordenar orígenes ascendentes intencionadamente:

  El canal comprueba las fuentes ascendentes secuencialmente y devuelve el paquete de la primera fuente que lo contiene. Si usa varias fuentes ascendentes, ordénelas de modo que el canal resuelva los paquetes desde la fuente deseada. Esta ordenación es importante cuando se usa una combinación de registros públicos y fuentes internas, o cuando la organización vuelve a publicar paquetes de código abierto personalizados internamente. Para obtener más información, consulte Ordenar las fuentes ascendentes de forma intencionada y Orden de búsqueda.

• Use vistas de fuente para controlar lo que ven los consumidores:

  Si el equipo promueve las versiones de paquetes validadas a través de vistas de fuente, use esas vistas para compartir solo las versiones de paquete destinadas a un público determinado. Por ejemplo, puede mantener los paquetes recién publicados en @local, compartir compilaciones en versión preliminar a través @prereleasede y compartir paquetes aprobados a través de @release.

• Use el localizador de fuentes para fuentes de varias organizaciones en el mismo inquilino:

  Si los orígenes están en el mismo inquilino de Microsoft Entra pero no forman parte de su organización, use el localizador de fuentes. La sintaxis es azure-feed://<organization>/<projectName>/<feed>@<view>.

Contenido relacionado

• Límites en las versiones y tamaños del paquete

• Supervisión del consumo de almacenamiento de artefactos

• ¿Qué son los orígenes ascendentes?