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 and Build 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.