Promotion Flow

Introduction

Promotion flow is the process of moving a software application or deployment from one environment to another. In a typical software development lifecycle, promotion allows you to transfer changes made in a lower-level environment, such as development or staging, to a higher-level environment like production. This documentation outlines the steps involved in promoting a deployment within your application.

Prerequisites

Before you proceed with the promotion flow, ensure the following:

  • You have access to the application you want to promote.
  • You are familiar with the target workspace and the application to which you want to promote your deployment.
  • You have the necessary permissions to promote deployments.

Promoting a Deployment

Follow these steps to promote a deployment:

  1. Open the Promotion Flow Form:
    1. Locate the application you want to promote.
    2. Click on the vertical ellipsis (three dots) icon associated with the application.
      Promotion Menu
    3. In the dropdown menu, select the Promote option.
  1. Complete the Promotion Form:
    A promotion form will appear, prompting you to provide the following details:
    1. Where would you like to deploy?:
      Select the workspace to which you want to promote your application. This determines the target environment for the promotion.
    2. Select the target application:
      Choose the target application within the selected workspace. This is the application that your deployment will be promoted to.
      After selecting the target workspace and application, click on the "Next Step" button to continue.
  1. Review Differences:
    You will now be presented with a comparison of the differences between your target application and the lower-level environment application you are promoting from. These differences typically include:
    1. Code Changes: Any modifications made to the source code and build specifications.
    2. Environment Variables: Changes in the environment variables.
      Review these differences to ensure you understand the impact of the promotion.
    3. Other environment independent configurations of the deployment.

📘

Note:

Configurations like replica count or rollout configurations are not carried over from the lower environment

  1. Initiate the Promotion Process:
    After confirming that the differences are as expected and you are ready to proceed with the promotion, click the Submit button.
    Upon clicking Submit, the system will initiate the promotion process. This involves pushing the changes from the lower-level environment to the target application.
  2. Monitor Progress:
    Now you can see the deployment progress. In a few seconds, you should see the new version being deployed to your target application, and your target application should be successfully promoted.