Build Configuration Template

Build Configuration Template allows you to eliminate duplication of build configuration settings. If you want to have several similar (not necessarily identical) build configurations and be able to modify their common settings in one place without having to edit each configuration, create a build configuration template with those settings. Modifying template's settings affects all build configurations associated with this template.

You can create a build configuration template in two ways:

Create new template manually. This process is similar to creating regular build configuration. For more information, please refer to the Creating and Editing Build Configurations page.
Extract new template from a build configuration. To do so, navigate to the desired build configuration settings page, click Extract Template and type a name for the new template in appeared dialog window. Please note, that in this case the build configuration, from which the new template was extracted, will be attached automatically to this newly created template.

When a template is created, you can associate with it any number of build configurations.
To do so, navigate to the build configuration settings page, click Associate with Template in the side bar, and specify particular template to associate current configuration with.

If a build configuration is associated with a template, then settings of this build configuration are inherited from the template. However, some settings can be extended or redefined by means of configuration parameters in the inherited configuration:

Build Configuration Setting	Possible to extend/add more?	Can be redefined via configuration parameters?	Can be removed?
Properties & Environment variables
Agent Requirements
Snapshot dependencies
Artifact dependencies		partly allowed via parameter references in text fields
Checkout rules
VCS trigger include rules
VCS roots set
Build triggers
Build steps
Build features
Text fields (in most cases)
Checkbox settings

Refer to Configuration Parameters for more details on redefining settings.

When you detach build configuration from a template, all settings from the template will be copied to the build configuration and enabled for editing.

Template which has at least one associated build configuration cannot be deleted.

See also:

Administrator's Guide: Creating and Editing Build Configurations | Configuration Parameters

Build Configuration Template

Labels: