Naming versions for deployment releases

Simple release versioning

Simple release versioning allows you to specify a starting release number, for example 1.0, which Bamboo will automatically increment. When using simple release versioning, Bamboo will increment the final number in the release name. For example:

To configure simple release naming:

1. Click the Release versioning button on the 'Deployment project configuration' screen to display the 'Release versioning' screen:

   

2. Complete the 'Release versioning' screen using the following fields:

   Field	Description	Optional?
   Create release name	The identification for the next release name that Bamboo will create. In simple release naming, you should use something straightforward like 1.0.
   Automatically increment with each new release	Check the 'Numbers' check box to automatically increment the release number according to the 'Next release name' field, as defined above. If you leave this box unchecked, then no release number incrementing will occur.
   Preview	This field allows you to preview what the next release name will look like. To view the preview, click on the Generate preview button next to the 'Create release name' field. Note: In some cases a preview may not be available.	-

3. Click Save to save your changes.

Release versioning using variables

Release versioning using variables allows you to develop more complex naming schemes, based upon variables set up within Bamboo. You can use global, plan and build variables in your releasing scheme.

Example

You may have a plan variable called 'planvar' with a value of 'm6'. By including this variable key within the 'Next release name' field, Bamboo will automatically add the variable value to the next release name, and increment it accordingly:

To configure release naming using variables:

1. Click the Release versioning button on the 'Deployment project configuration' screen to display the 'Release naming' screen:
   

2. Complete the 'Create release name' field using the following data:

   Field	Description	Optional?
   Version	The identification for the next release name that Bamboo will create. In simple release versioning, you should use something straightforward like 1.0.

3. Click on the Add variable to release name link to display the Variables selection screen:
   
4. Click Add variable to include the variable in your release naming scheme. Click on Close to return to the 'Release naming' screen

5. Complete the 'Release name' field using the following fields:

   Field	Description	Optional?
   Automatically increment with each new release	1.Check the 'Numbers' check box to automatically increment the release number according to the 'Next release name' field, as defined above. If you leave this box unchecked, then no release number incrementing will occur. 2. Check the 'Variables' check box to include the associated variable in your automated release number incrementing plan.
   Preview	This field allows you to preview what the next release name will look like. To view the preview, click on the Generate preview button next to the 'Create release name' field. Note: In some cases a preview may not be available.	-

6. Click Save to save your changes.

Example release versioning schemes

Bamboo also allows you to use combinations of simple and variable release naming. The following table provides examples of combined naming schemes, and demonstrates how careful control of the Numbers and Variables checkboxes can be used to customise your scheme.

Naming scheme	Next release field	Numbers checkbox	Variables checkbox	Variable value	Next release name	Subsequent release name
Static naming	1.0			-	1.0	1.0
Naturally unique variable	1.0-${bamboo.buildNumber}			13	1.0-13	1.0-13
Number incrementing	1.0			-	1.0	1.1
Number incrementing + static variable	1.0-${bamboo.appName}			${bamboo.appName} Plan or Global variable: Awesome	1.0-Awesome	1.1-Awesome
Variable incrementing	1.0-${bamboo.milestone}			${bamboo.milestone} Plan or Global variable: m6	1.0-m6	1.0-m7
Number and variable incrementing	1.0-b${bamboo.appNumber}			${bamboo.appNumber} User defined variable: 1567	1.0-b1567	1.1-b1568