Quick start: Advanced Promotion Flow with Promotion Workflows

Promote product apps between multiple environments with promotion conditions

Advanced Promotion Flow with Promotion Workflows quick start

Promotion Flows allow you to automate promotions across multiple environments.

This quick start explores how to enhance Promotion Flows by configuring conditions for each environment through Promotion Workflows.
Promotion Workflows define the conditions under which changes are promoted to the next environment. They automate testing, validation, and other required checks, establishing gates to enforce promotion criteria.

For this quick start, we’ll use the same Promotion Workflows created in Quick Start: Creating Promotion Workflows within the Promotion Flow.

For detailed information, see Configuring Promotion Workflows.

Promotion Workflows in Promotion Flows

Promotion Workflows define the conditions required for changes to be promoted to the next environment. They automate testing, quality checks, validation, and other deployment requirements for environments.

You can create workflows tailored to the specific tasks required during a promotion and categorize them based on when they run in the promotion process, as Pre-Action or Post-Action Workflows.

Pre-Action Workflows

A Pre-Action Workflow runs before the promotion action is triggered. These workflows handle tasks like smoke tests, unit tests, security scans-any validation that must pass before a change is promoted. If the Pre-Action Workflow fails, the promotion is blocked, ensuring that only approved changes are advanced.

In this quick start, we’ll use the ServiceNow Promotion Workflow to open a change request before the promotion starts.

Post-Action Workflows

A Post-Action Workflow runs after the promotion action has completed. These workflows handle tasks like performance monitoring, database migrations, or stakeholder notifications.
Post-Action Workflows help verify that promoted changes behave as expected in the new environment and allow teams to respond to any issues.

In this quick start, we’ll use the Slack notification Promotion Workflow to send a Slack notification when the promotion is complete.

Requirements

• GitOps Runtime
• Git Source to store application manifests
• Products and applications
  • Each environment must have an application for the product. For example, demo-trioapp-dev, demo-trioapp-qa, and demo-trioapp-prodrepresenting the development, testing, and production versions.
  • The repository structure must be consistent across all applications.
    If it works for you, copy the corresponding subfolders in demo-applications with the resources.
• Environments
  A Promotion Flow requires at least three environments. In this quick start, we use dev, qa, and prod.
• Promotion Workflows

Assign Pre- and Post-Action Workflows to environments in Promotion Flow

To ensure each environment’s specific requirements are met, assign Promotion Workflows to govern promotion behavior.
In this quick start, we’ll select the Promotion Workflows to govern promotion behavior for the qa and prod environments.

1. From the list of Promotion Flows, select the Promotion Flow you created, multi-env-sequential-promotion for the quick start.
2. In the Settings panel, update the Version to indicate changes in the flow, for example, 2.0.
3. Select the Promotion Workflows and the Promotion Action from the list. The following examples show the Pre-Action Workflows available, and the qa environment configured with the Pre- and Post-Action Workflows and the Promotion Action.

4. Repeat step 3 to configure Promotion Workflows and Actions for the other target environments in the Promotion Flow. For this quick start, we’ll select the same workflows and the same promotion action for prod as we did for qa.

Here’s the YAML view of the flow with the Promotion Workflows and Promotion Actions.

5. To save the changes, click Save Promotion Flow.
6. Continue with Trigger Promotion Flow and monitor Product release.

Trigger Promotion Flow and monitor product release

Trigger the Promotion Flow updated with the configured Pre- and Post-Action Workflows, and monitor its progress.

Unlike the previous release (without workflows), this release for the same Promotion Flow (multi-env-sequential-promotion), only promotes changes to the next environment when all workflows associated with the current environment are complete.

1. Open the Promotion Flow, for example,multi-env-sequential-promotion and click Trigger.
2. Select the product, the application to promote, and then click Trigger once again.
3. Click View Release Details.
   The following example shows the qa and prod environments with their respective Pre- and Post-Action Workflows.

What’s next

The final quick start on promotions covers creating dependencies between environments to define the order for promotions.

Quick start: Advanced Promotion Flow with environment dependencies