Creating and configuring a deployment project


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.
  • Releases which represent the actual software artifacts being deployed - these include the issues and commits which make up the release.

To create a new deployment project you need to:

  1. Provide a name and a description that represents your project.
  2. Associate the project with a build plan. The build plan will produce the artifacts you will snapshot into a release and deploy to the environment. Associating the deployment project with a build plan tells the deployment project which set of artifacts to use for the deployment.

If you are using plan branches, you will also need to associate the deployment with the plan branch. The plan branch represent a build for a branch within the version control system that inherits the configuration defined by the parent plan. Any new branch created is automatically built and tested using the same build configuration as the parent. When the plan branch build succeeds, it can be merged back into master.

Learn more about Deployments from branches.

Creating a new deployment project

To create a new deployment project:

  1. Select Create > Create deployment project in the dropdown menu from the top navigation bar. If your build plan has a plan branch, Bamboo will detect it and offer an additional field for completion.
    Create deployment project screen

  2. Complete the Create deployment project screen using the following fields:

    FieldDescriptionOptional?
    NameThe name of your deployment project.(error)
    DescriptionA brief description of your deployment project.(tick)
    AccessSelect the checkbox to make the deployment project visible to all users.(tick)
    Build planThe name of the plan you wish to associate with the deployment project. This field identifies the source of your deployment artifacts.(error)
    Use the main plan branch/Use a custom plan branchThe plan branch that you wish to deploy. Bamboo will auto detect available plan branches for you.(error)
  3. Select Create deployment project.
    Deployment project configuration page
    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, select more actions menu icon > Edit project details.
    Update deployment project screen

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

    FieldDescriptionOptional?
    NameThe name of your deployment project.(error)
    DescriptionA brief description of your deployment project.(tick)
    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)
    Use the main plan branch/Use a custom plan branchThe plan branch that you wish to deploy. This option will only display if your plan has a valid branch, as described above.(error)
  3. Select Save deployment project.

Configuring release naming

Bamboo's release naming configuration allows you to control:

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

See Naming versions for deployment releases for more information.

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. On the Deployment project configuration screen select Project permissions.
  2. Select Add user or Add Group to search for and add users or groups.

  3. Check the relevant View, View configuration (Bamboo Data Center only), and Edit permission boxes to assign your desired permission scheme, and select Add.

Viewing a Bamboo deployment project as Java or YAML Specs

Bamboo instance administrators can view the deployment configuration as Java Specs in Deployment project configuration > more actions menu icon > View Project as Java Specs or View Project as YAML Specs.

More actions menu in deployment project configuration

Last modified on Jul 26, 2021

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.