This document will run through how to get your first features from your dev sandbox into your pipeline and then get those features through your pipeline environments.

Promoting work from a dev sandbox

Promoting work from a dev sandbox into your pipeline is easily done through Gearset. While you can manually compare and deploy from your dev org to your source branch, we helpfully provide this functionality within the Pipelines UI.

We’ve created a custom field within our dev org that looks like this:

In the deployment pipelines view, we can click on the Dev sandbox environment, click the branch name (feature-alpha in the screenshot below) and create a new feature branch, then click on the Compare and commit option within our sidebar view:

This will start a comparison between the dev sandbox org and our new feature branch and allow us to choose the new custom field to commit:

Once the commit to the feature branch is complete, click Create pull request in our pipeline environment view to start the feature’s journey through the pipeline:

You can see the target environment is pre-populated with the next integration (INT) environment:

Once this pull request is open, the pipeline view is updated with the indication that a new feature is ready for promotion into the next environment:

We’ve now successfully promoted the feature from the dev sandbox environment to the feature branch, and are ready to target our first environment, i.e. the INT environment.

Promoting a change through your pipeline

Once a pull request is open and displayed in front of an environment, we can select the environment to see the pull request and feature ready for promotion:

We can select the pull request (or multiple pull requests) and click Promote changes to promote into each of the subsequent environments in the pipeline:

Clicking the Promote changes button will then start the CI job on the Gearset side, to:

  • merge the pull request to take the feature into the next git branch (i.e. the int branch)

  • start the CI job to deploy this feature into the next org (i.e. the INT org), indicated by the spinning circle

  • open a pull request of this feature against the next environment (i.e. the UAT environment) in the pipeline.

When the CI job to promote the feature into the INT org is complete, this is what we’ll see:

You can now continue to move the changes down the pipeline and towards production.

Using JIRA with pipelines

If we want to associate each promotion of changes with a Jira ticket, Gearset can attach comments to the selected Jira ticket to update your ticket tracking software.

Did this answer your question?