Unify Release is a simple build task for Azure DevOps to enable two or more builds from the same source code to trigger a single Release.
By default if you have a release that get triggered by two different builds (even if those builds are triggered from the same source version), this release will be run for each time one of this builds are completed
With the unify release task, you are able to control the releases in a way that two builds triggered from the same source version can generate only one release.
This scenario is common especially with Mono Repository approach, where you need to make changes in two different applications that must go live in the same release.
-
The Unify release tasks when executed from a Build pipeline, checks the other builds triggered from the same source version.
-
If no builds are pending it will create a build tag that you can use to filter in your release pipeline.
-
If there's a build pending, it will not create the build tag, so your release pipeline (with the build tag filter enabled) will not be triggered.
In this way, only the last build to finish will create the build tag and the pipeline will be run.
-
Install the Unify Release Task from the Azure DevOps Marketplace.
-
Put the Unify release task in your build pipelines as the last task to be executed.
-
In your Agent Configuration, active the Flag: Allow scripts to access the OAuth token
- In your Release Artifacts, put a Build Tag filter for the build tag you configured on the Unify Release Task (default to create_release).
| Parameter | Description | Default Value |
|---|---|---|
| Release Tag | Name of the build tag that will be created if the build is the last one to be completed. | create_release |
| Wait for All Triggered Builds | Indicates that the Unify Release Task should consider all build definitions tiggered by the same source version. When wait for all triggered builds is false, you can specify which builds the Unify release task is going to consider to evaluate if the build tag should be created. | true |
| Project | Project where the build definitions to be considered are stored. | null |
| Related Definitions | Indicate which build definitions should be considered by the unify release task. | null |
| Release on Error | Indicate that the build tag should be created even if one of the related builds fails. | false |
| Release on Cancel | Indicate that the build tag should be created even if one of the related builds is cancelled. | false |