Build Promotion can be enabled by editing advanced setting of configuration and choosing "enable promotion" for promotion setting property as demonstrated below:

Once it is enabled, a promote button will appear on the successful build screen (please note that if recommended only option is checked when enable the promotion, the promote button will only appear on the recommended build screen). Be aware that, during the promotion process, the repository used in source build will override the repository used in destination build with the same name. This won't be a problem if the source build and destination build uses the same set of repositories.

Control promotion process

Variables can be defined in the promotion setting screen to control the promotion process. For example, you may have the destination build using the version as source build if:

1. The property next build version of destination configuration is specified as ${vars.get("promoteVersion")}.
2. A promotion variable is defined in promotion setting of the source configuration, with the name set to promoteVersion, and value set to ${build.version}.

If you would like version of destination build being prompted in the above example, you may leave value of the variable promoteVersion empty, and specify its prompt setting as prompt as text input.

Define multiple promote destinations

For simplicity reasons, QuickBuild only allows to define one promote destination by default. However, you can define multiple configurations with the help of scripting and variables. Below screenshot demonstrates this:

In this screenshot, the configuration path is defined to take value of promote variable destination. At the same time, the variable destination is defined to display a selection box having the user choose the promote destination when the promote button is pressed. In this way, multiple promote destinations are defined and can be selected at promote time. You can also make the destination prompting for a text field, if you want to specify arbitrary configuration at promote time.

Change detection

In a build promotion process, changes of destination build are calculated by comparing repository revision of current destination build against previous destination build, instead of previous source build. This is well explained here.