Deployment Packages

Overview

Deployment Packages are a key component of the Deployment Server, enabling customers to move their projects efficiently and reliably between environments. They provide a structured way to track, manage, review, and audit changes across the development lifecycle, ensuring that all necessary work is deployed with confidence.

Deployment Packages allow teams to organize related sets of modifications, clearly identifying what has been added, changed, or removed. Visual indicators distinguish these changes, such as blue for modified items and red for removed items, making it easier to understand the scope of each package.

Role Within the Deployment Server Workflow

Deployment Packages integrate tightly with the overall Deployment Server workflow, serving as the units through which project changes are bundled for deployment. They facilitate thorough review and approval processes, helping ensure that every change is accounted for and validated before moving to the next environment.

Each package includes all the information necessary to move work seamlessly from development environments to testing or production environments, minimizing risks and improving the reliability of deployments.

Deployment Environment Setup and Usage

Deployment Packages are deployed within environments configured specifically for this purpose. For each customer environment, a deployment server is set up alongside a target environment where the packages are applied. This setup allows teams to test and interact with the deployment process fully, providing valuable insights into how packages behave in real-world scenarios.

This controlled environment ensures that issues can be identified and addressed early, supporting a smooth and predictable deployment experience.

Refer to Connecting the Development Server to the Deployment Server for setup guidance.

All committed changes can be found under All Organizations > [Organization Name] > Deployments, listed as Deployment Packages.

The Deployment Packages list includes a Version column that displays the package version in the format [MajorVersionNumber].[PackageNumber].[BuildNumber].

Deployment Package Versioning

Deployment Packages display a version label in the Version column using the format: [MajorVersionNumber].[PackageNumber].[BuildNumber].

Major: A manually set number that represents a major release line (default is 1).
Package: The Deployment Package number. The first package starts at 0, and this number increments when a new package is created.
Build: The number of builds created within the current package. This increments when work is added/committed to the package.

How the Version Changes

New package: A newly created package starts at 1.0.0.
Build creation: When a build is created for the package (for example, when user stories are included and changes are committed), the Build number increments: 1.0.1, 1.0.2, and so on.
New package after release: When a package is completed and promoted to the final environment (for example, Production), a new Deployment Package is created. The Package number increments and the Build number resets to 0 (example: 1.0.6 → 1.1.0).

Set Major Version

The Major number can be changed using the Set Major Version action.

Caveat: If the Major version is changed, the Package number is reset back to 0.

Example

Scenario	Example Version
The first Deployment Package is created	1.0.0
The first build is created in the package	1.0.1
Multiple builds created in the same package	1.0.6
Package is promoted to Production → new package created	1.1.0
Major version is changed (example: set to 5)	5.0.0

Note:

Environment tiles above the Deployment Packages table (for example, QA) may show a version number to indicate which Deployment Package version that environment is currently running. This is informational and helps teams confirm where this environment is in the deployment lifecycle.

Adding User Stories to a Deployment Package

There are two ways to add User Stories to a Deployment Package:

Include in Deployment Package: This action is available at the User Story level. Navigate to: Project > Sprints > User Stories. A User Story can be included in the current active Deployment Package in one of the following ways:
- During creation: Select the Include in Deployment Package checkbox while creating the User Story.
- When editing: Edit an existing User Story and select the Include in Deployment Package checkbox.
Edit Deployment Package: Right-click on an in-progress Deployment Package and select Edit. This opens the Edit Deployment Package dialog, where relevant User Stories can be selected for inclusion. After selecting the required items, click OK to confirm.
Note
Once one or more User Stories are added to a Deployment Package, either through Include in Deployment Package or Edit Deployment Package, a build is automatically created for that Deployment Package, which increments the Build number in the package Version.

Deploying a Package

To initiate deployment, right-click on the Deployment Package and select Deploy. A dialog will appear, prompting a selection of the target environment from a dropdown menu. After selecting the appropriate environment, click Continue to proceed with the deployment.