Hi @sebastian,
Thanks for asking this. We will definitely explain this better in our docs prior to the launch of ProGet 2024. Basically, the concept of build stages was a way to track your project through it's build lifecycle. Since the scan needs to be performed against the source code, a build is typically added at you CI server's build stage. Then the version will be promoted between stages until it is released. During this process, there are typically multiple CI builds that are created and then rejected before going to release. ProGet's build stages give you the ability to automatically handle archiving old versions and determine at what stage an automated build analysis should create issues.
With all that said, you can customize these build stages by navigating to Reporting & SCA -> Projects and then hover over the multi-button in the upper right corner and select "Build Stages". From there, you can modify the settings for how builds are handled in each stage (scan for issues, number of active builds to keep, etc...) and create new build stages to match your CI/CD process.
ProGet includes 4 stages out of the box and they are configured to do the following by default:
- Build: Archive other builds except the latest 10.
- Integration: Archive other builds except the latest 3.
- Test: Archive other builds except the latest 3 and create issues for noncompliant packages.
- Production: Archive other builds except the latest 1 and create issues for noncompliant packages.
I hope this helps! Please let us know if you have any other questions.
Thanks,
Rich