Quick start: Advanced Promotion Flow with parallel environments

Promote product apps between environments in parallel

Advanced Promotion Flow with parallel environments quick start

Parallel environments allow promotions across multiple environments. Parallel promotions are ideal for scenarios like multi-region deployments, where updates must be promoted simultaneously to designated regions before proceeding to a production environment.

This quick start describes how to configure parallel promotions in Promotion Flows.

Requirements

• GitOps Runtime
• Git Source to store application manifests
• Environments
• Products
• 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 structure of the repos with the resources accessed by the applications must be consistent across all the three applications.
  If it works for you, copy the corresponding subfolders in demo-applications with the resources.

Follow-along Git repo

You can copy the manifests and the resources for the new applications from the example GitHub repository.

• Application manifests
  • trio-prod-asia
  • trio-prod-eu
• Application resources
  • trioapp-prod-asia
  • trioapp-prod-eu

Add parallel environments to Promotion Flow

We’ll enhance the Promotion Flow by adding multiple environments to execute promotions in parallel.

Before you begin

• Ensure that you have:
  • More than one production environment
    For the quick start, we created prod-asia and prod-eu as additional production environments.
  • Applications in each of the new environments
    For the quick start, we created two different applications demo-trioapp-eu, demo-trioapp-asia, aligned to prod-asia and prod-eu.

Step-by-step

1. Open the Promotion Flow you created, multi-env-sequential-promotion for the quick start.
2. Open the Settings panel:
   • Name: Change the name to create a new Promotion Flow, multi-env-parallel-promotion.
   • Version: Change the version to 1.00.
3. Mouse over the right of the environment node before the final one in the flow and add the new environments you created. For the quick start, we’ll add prod-eu and prod-asia to qa.

4. Click Save Promotion Flow.

Below are the Chart and YAML views of the Promotion Flow.

5. Continue with Trigger and view product release for parallel environment promotion.

Trigger and view product release for parallel environment promotion

Trigger the new Promotion Flow with parallel environments to create a new release for the product. Monitor the release to see changes promoted simultaneously across all defined parallel environments.

1. Open the Promotion Flow with the parallel environments, multi-env-parallel-promotion for the quick start, and click Trigger.
2. Select the product, the application to promote, and then click Trigger once again.
3. Click View Release Details.

The Release view displays the parallel structure of the Promotion Flow, with simultaneous promotions across prod, prod-eu, and prod-asia.

What’s next

The final quick start on promotions will guide you through creating dependencies between environments to define the order for promotions.

Quick start: Advanced Promotion Flow with environment dependencies