How to Create a Promotion

Updated 3 weeks ago by Copado Solutions

Promoting a Single User Story

Copado allows you to promote user stories individually with the Promote and Deploy feature. This can be useful, for instance, if you want to apply a minor fix to a bug which does not share any dependency to another user story.

When using the Promote and Deploy feature, Copado will create a Promotion and a Deployment of the selected user story and will automatically execute the deployment.

To promote a single user story:

  1. Navigate to the user story you want to promote.
  2. Check the Promote and Deploy checkbox.

Promoting Multiple User Stories

Copado allows you to promote user stories in bulk integrating them in a single promotion. In order to do this, the user stories you want to promote must be flagged as Promote Change.

Once the user stories are flagged as Promote Change, they will be ready to be promoted and will be available for selection.

You can promote multiple user stories in 2 ways:

  • From the Promotion Record
  • From the Pipeline Manager page (Summer ‘19) or Release Management page (v12).
From the Promotion Record
  1. Before creating the Promotion record, make sure that the user stories have been marked as Promote Change.
  2. Navigate to the Promotions tab and click on New.
  3. Select the Project or the Release. It is possible to create a promotion for user stories that belong to a project or to a release regardless of the project.
  4. Add the Source Environment. Copado will automatically fill in the source org credential, the destination environment and the destination org credential based on the pipeline related to the project/project's release and the available credential owned by the running user.
If an org credential is marked as Default Credential, the promotion will use that credential regardless of the owner. This allows sharing the "deployment" org credential among multiple release managers. This behavior can be modified following the steps detailed in the article Org Credentials Update.
  1. Locate the required user stories from the Available User Stories list, mark them and click on Add selected User Stories. The selected user stories will be displayed now under the Selected User Stories related list.
  2. When using Promote Change, Copado will not create the deployment automatically, this will have to be manually performed from the Promotion record. To learn more, please visit the article Creating a Deployment.

From the Pipeline Manager Page

This Interface is available if you are in Copado version Summer '19.

  1. First, ensure the user stories have been marked as Promote Change.
  2. Navigate to the Pipeline and locate the Manage Releases field. Then, click on the Pipeline Manager link to open the Pipeline Manager page.

  1. Click on the arrow beside the user stories ahead count.

  1. This will open a new page where all the user stories ready to be promoted sit in this environment will be listed, regardless of their project.

  1. Flag the user stories you are interested in promoting and choose the test level you want to apply in the deployment.

  1. Click on Promote (you will later need to manually create and launch the deployment) or on Promote & Deploy (Copado will automatically create and deploy the back promotion records).

From the Release Management Page

This Interface is available if you are in Copado v12.

  1. Navigate to the deployment flow and locate the Manage Releases field. Then, click on the link to open the Release Management page.
  2. In the Release Management page, use the arrow for the environment where you want to promote the user stories.
  3. After clicking on the back arrow choose the User Stories Ahead tab.
  4. Choose the Project or Release that contains the user story.
  5. Select the user stories you want to back promote.
  6. Click on Promote (you will later need to manually create and launch the deployment) or on Promote & Deploy (Copado will automatically create and deploy the promotion records).


How did we do?