Naming versions for deployment releases

Creating and configuring a deployment project

このページの内容

お困りですか?

アトラシアン コミュニティをご利用ください。

コミュニティに質問

Bamboo provides a range of options that allow you to control your release naming scheme. You can specify how Bamboo handles release versioning, and control automatic incrementing between releases.

Bamboo allows you to use:

  • Simple incremental numbering 
  • Advanced numbering based upon Bamboo variables

Bamboo also allows you to manually override automatic release settings when you create a new release.

このページの内容

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:

Release nameIncremented release name
12
1.11.2
1.111.12
1.0.11.0.2


To configure simple release naming:

  1. Select Release versioning on the Deployment project configuration screen.

    Release versioning screen in deployment project configuration

  2. Complete the fields using the following data:

    フィールド
    説明
    Optional?
    Next releaseThe identification for the next release name that Bamboo will create. In simple release naming, you should use something straightforward like 1.0.(error)
    If you want the naming scheme for the release to be applied to branches, select Apply the same naming scheme to releases created from branches.
    (tick)
    Automatically increment with each new releaseSelect the Numbers checkbox to automatically increment the release number according to the Next release field, as defined above. If you leave this box unchecked, no release number incrementing will occur.(tick)
    プレビュー

    This field allows you to preview what the next release name will look like. To view the preview, select the Generate preview button.

    Note: In some cases, a preview may not be available.

    -
  3. 保存 を選択します。

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.

For security reasons, you can't use password variables in version names.


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

Variable key変数の値Next releaseNext release versionSubsequent release version
planvarm61.0-${bamboo.planvar}1.0-m61.1-m7


To configure release naming using variables:

  1. Select the Release versioning button on the Deployment project configuration screen.
    Release versioning screen in deployment project configuration
  2. Complete the Version field using the following data:

    フィールド
    説明
    Optional?
    バージョンThe identification for the next release name that Bamboo will create. In simple release versioning, you should use something straightforward like 1.0.(error)
  3. Select the Add variable to version link to display the Variables selection screen:
    Release versioning variables screen
  4. Select Add variable to include the variable in your release naming scheme. Then select Close to return to the Release versioning screen.
  5. Complete the remaining fields using the following data:

    フィールド
    説明
    Optional?
    Automatically increment with each new release1. Select the Numbers checkbox to automatically increment the release number according to the Next release field, as defined above. If you leave this box unchecked, then no release number incrementing will occur.
    2. Select the Variables checkbox to automatically increment selected variable(s) when a new release is created. If matching plan variable exists, its value is incremented, otherwise matching global variable is incremented. Additionally, if a release is created from a branch while the Apply the same naming scheme to releases create from branches option is on, the branch variable is incremented (as long as it exists). Please note, injected variable values (from the Inject Variables task) cannot be automatically incremented using this option.
    (tick)
    プレビュー

    This field allows you to preview what the next release name will look like. To view the preview, select the Generate preview button.

    Note: In some cases, a preview may not be available.

    -
  6. 保存 を選択します。

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 customize your scheme.

Naming schemeNext release fieldNumbers checkboxVariables checkbox変数の値Next release nameSubsequent release name
Static naming1.0(error)(error)-1.01.0
Naturally unique variable1.0-${bamboo.buildNumber}(error)(error)131.0-131.0-13
Number incrementing1.0(tick)(error)-1.01.1
Number incrementing + static variable1.0-${bamboo.appName}(tick)(error)

$ {bamboo.appName}

Plan or Global variable: Awesome

1.0-Awesome1.1-Awesome
Variable incrementing1.0-${bamboo.milestone}(error)(tick)

$ {bamboo.milestone}

Plan or Global variable: m6

1.0-m61.0-m7
Number and variable incrementing1.0-b${bamboo.appNumber}(tick)(tick)

${bamboo.appNumber}

User defined variable: 1567

1.0-b15671.1-b1568
最終更新日 2021 年 8 月 10 日

この内容はお役に立ちましたか?

はい
いいえ
この記事についてのフィードバックを送信する
Powered by Confluence and Scroll Viewport.