Using version naming

Simple version naming

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

To configure simple version naming:

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

    

2. Complete the 'Version naming' screen using the following fields:

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

3. Click Save to save your changes.

Version naming using variables

Version naming 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 versioning scheme.

Example

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

To configure version naming using variables:

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

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

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

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

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

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

6. Click Save to save your changes.

Example version naming schemes

Bamboo also allows you to use combinations of simple and variable 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 version field	Numbers checkbox	Variables checkbox	Variable value	Next version name	Subsequent version 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