Package Promotion is the process of promoting packages between feeds to ensure that only approved and verified packages are used in the right environments, such as production.
In ProGet, packages can be promoted from one feed to another and tracked throughout the process. This allows you to build a promotion pipeline that allows you maintain separate levels of quality in different feeds (such as Development, Production, etc). It also enables you to easily curate selected packages from an external source to an approved repository.
This feature is limited in ProGet Free. Compare features by edition or request a quote.
There are two ways to promote a package, using the Promote Package button in the Package Version page in ProGet, or an API call. Any packages that are promoted to a target feed are not deleted from the source feed.
Any feed can be used as a validated/promoted package feed, but best practice is to create a separate feed that contains only promoted internal packages and verified external packages. When creating your new feed, select the validated/promoted feed usage type.
To promote a package using the Package Version page, first navigate to the feed, package, and version you would like to promote. Hover over the ▼-button in the upper right corner and click the Promote Package button.
Package Promotion via the package version page is limited in ProGet Free. When using ProGet Free, you can promote packages, but only through this page and you won't be able to see who did it, when, or why.
To promote a package via the API you will first need to generate an API key that grants access to Package Promotion. Then visit our Package Promotion Endpoint guide in our ProGet API Reference section to familiarize yourself on how to work with the ProGet APIs and the Promote Packages endpoint.
Package promotion via the API is not availabile in ProGet Free.
A package promotion pipeline helps you to enforce the process of elevating packages between your different feeds/environments by selecting a specific target feed. Once a target feed is selected to promote to, both the Package Version Page and the Package Promotion Endpoint will only allow you to promote packages to the selected target feed.
To configure the pipeline, you will need to:
Note: A validated/promoted package feed can be a source feed for a different validated/promoted package feed. This allows you to keep environments separated into different feeds and enforce an elevation process across feeds.
Promote Packages is a built-in task in ProGet. This task Allows access to promote packages to a specified feed of the same feed type. Users granted this task should also be granted at least the View & Download Packages task for the source feed.
You can also create a Custom Task page by going to Administration > Users & Tasks > Customize Tasks
. To give or deny users/groups permissions to this task go to the Users & Tasks page.
Package promotion tracking is viewable in the History tab on the Package Version page. The history will show a Promoted action that includes:
Action | On | Detail |
---|---|---|
Promoted | 5/14/2020 1:30:15 PM by Admin | from devnuget to rcnuget Ready for testing |
Promoted | 5/15/2020 1:30:15 PM by API | from rcnuget to prodnuget Release 12.0.5 |
Is this documentation incorrect or incomplete? Help us by contributing!
This documentation is licensed under CC-BY-SA-4.0 and stored in GitHub.