Component promotion

You can use component promotion to flow all of the dependency build artifacts that are associated with one or more components from a source level to a target level in your promotion hierarchy. Component promotion replaces the selected components in the target stream with the components in the snapshot that is associated with the latest source build result, and will also copy all of the source code data for the selected components from the source to the target level. All build outputs that are not promoted yet are copied from the source level to the target level on the build machine, and all associated build maps are copied to the target level. A target build is requested as part of the promotion, and no programs are rebuilt in the promoted components.

In the case of a source build enabled to consider additional flows, the components that come from the additional flows must be available for the target build. They are available if they are contained in the target build definition stream or if they flow to the target build definition workspace and the definition is in turn also enabled to consider additional flows. See Resolving dependencies from components in a different stream.

To promote component-based artifacts, the following tasks are required:

• Create dependency builds for the source and target builds of the promotion build.
• Create a promotion build to copy the source to the target.
• Request the component promotion build.