The functionality discussed on this page is only available in the Bamboo 5.0 EAP beta release.

 

Creating a deployment project from a plan is easy with Bamboo.

A deployment is a container that holds:

  • Environments that represent the physical environments, such as QA, Staging and Production 
  • Versions which represent the actual software artifacts being deployed - these include the issues and commits which make up the version.

To create a new deployment project you will need to:

  1. Provide a name and a description that represents your project
  2. Associate the project with a Plan that produces the artifacts you will snapshot in a Version and deploy to the environment.

On this page:

Creating a new deployment project

To create a new deployment project:

  1. Click on Create > Create deployment project in the drop down menu from the header bar. The 'Setup deployment project' screen will appear:
  2. Complete the 'Setup deployment project' screen using the following fields:

    FieldDescriptionOptional?
    Related Build PlanThe name of the plan you wish to associate with the deployment project Hint: This field identifies the source of your deployment artifacts(error)
    NameThe name of your deployment project(error)
    DescriptionA brief description of your deployment project(tick)
  3. Click on the Create deployment project button. The deployment project configuration screen will display:

    Your deployment project has been created with the build plan relation, name and description you specified. It is now ready for configuration.

Editing the details of an existing deployment project

Bamboo allows you to edit the details of an existing deployment project.

To edit the details of an existing deployment project:

  1. From the deployment project configuration screen, click the Edit details button. The Update deployment project screen will display:


  2. Complete the 'Update deployment project' screen using the following fields:

    FieldDescriptionOptional?
    Related Build PlanThe name of the plan you wish to associate with the deployment project Hint: This field identifies the source of your deployment artifacts(error)
    NameThe name of your deployment project(error)
    DescriptionA brief description of your deployment project(tick)
  3. Click on Save deployment project to save your changes.

Configuring version naming

Bamboo's version naming configuration allows you to control:

  • What Bamboo will call the next version the deployment project generates
  • Automatic incrementing of the version number each time a new version is created
  • Automatic incrementing of the version number as specified by a global variable each time a new version is created.

To configure your version naming strategy:

  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:

    FieldDescriptionOptional?
    Next version nameThe identification for the next version that Bamboo will create by replacing the ${bamboo.buildNumber} term with the numbering strategy of your choice. For example 1.0-m1.(error)
    Auto increment version nameCheck this box to automatically increment the version number according to the 'Next version name' field, as defined above.(tick)
    Auto increment global variablesYou may set Bamboo to increment version numbers according to a global variable. The global variables available will appear as part of the drop down menu in the 'Next version name field', however this field must be checked to activate global variable functionality. Available global variables will appear in the drop down menu when the 'Auto increment global variables' box is checked.(tick)
  3. Click Save to save your changes.

Configuring deployment project permissions

Bamboo gives you control over who has permission to View and Edit aspects of your deployment project.

To configure your permission strategy:

  1. Click the Permissions button on the 'Deployment project configuration' screen to display the 'Edit permissions' screen:
  2. Click the Add User or Add Group button to search for and add, users or groups

  3. Check the relevant 'View' and 'Edit' permission boxes to assign your desired permission scheme
  4. Click Save to save your permission scheme.
  • No labels