Learn how to use Cloud Manager to create and configure production pipelines to deploy your code. if you would first like a more conceptual overview of how pipelines work in Cloud Manager, please see the document CI/CD Pipelines.
Using the Pipeline Settings tile in Cloud Manager you can create two different types of pipelines.
This document focuses on production pipelines. For details on how to configure non-production pipelines see the document Configuring Non-Production Pipelines.
The Deployment Manager role is responsible for setting up the pipeline. Pipeline configuration consists of:
A pipeline can not be setup until its associated git repository has at least one branch and program setup is complete.
Once you have used the Cloud Manager UI to set up your program and have at least one environment, you are ready to add a production pipeline.
Log into Cloud Manager at my.cloudmanager.adobe.com and select the appropriate organization and program.
Navigate to the Pipelines card from the Program Overview page and click on +Add and select Add Production Pipeline.
The Add Production Pipeline dialog box opens to the Configuration tab where a number of options for your pipeline must be defined. These options are grouped into collapsible sections and are described in the following steps.
Provide a descriptive name for your pipeline in the Pipeline Name field.
Under the Source Code section, you define where the pipeline retrieves the code it will process.
See the document Program Setup to learn how to add and manage repositories in Cloud Manager.
Under the Environments section, you define what triggers a deployment and how it should be rolled out per environment.
In the STAGE section, you can define how the pipeline rolls out to your staging environment.
Deployment Trigger - You have the following options to define the deployment triggers to start the pipeline.
Important Metric Failures Behavior - During pipeline setup or edit, the Deployment Manager has the option of defining the behavior of the pipeline when an important failure is encountered in any of the quality gates. The available options are:
Deployment Options - You can accelerate certain deployment tasks.
Approve after Stage Deployment - This approval occurs after deployment to the staging environment before any testing is done. Otherwise approval occurs before the production deployment, which is done after all testing is complete.
Skip Load Balancer changes - Load balancer changes are not made.
Dispatcher Configuration - The Deployment Manager role can configure a set of content paths which will either be invalidated or flushed from the AEM Dispatcher cache when a pipeline is run. These cache actions will be performed as part of the deployment pipeline step, just after any content packages are deployed. These settings use standard AEM Dispatcher behavior. To configure:
Under PATH provide a content path.
Under TYPE, select the action to be taken on that path.
Click Add Path to add your specified path. You can add up to 100 paths per environment.
In general, the use of the invalidate action is preferable, but there may be cases where flushing is required, especially when using AEM HTML Client Libraries.
In the PRODUCTION section, you can define how the pipeline rolls out to your production environment.
Deployment Options - You can define the parameters controlling the production deployment.
Please refer to the document Code Deployment, to learn how to set the deployment schedule or execute the pipeline immediately.
Use CSE Oversight - If this option is select, a CSE is engaged to actually start the deployment. When creating or editing a pipeline when this option is enabled, the Deployment Manager role has the following options.
Dispatcher Configuration - Define the dispatcher configuration for your production environment. The options are the same as those for the staging environment.
Click on Continue to advance to the Stage Testing tab where you can configure AEM Sites and AEM Assets Performance Testing, depending on which products you have licensed.
Refer to the document Code Quality Testing for more details on the options available on the Stage Testing tab.
Under the Sites Content Delivery/Distributed Load Weight section, you define how sites performance testing is configured based on the weighting of page requests between the three page sets, which can be enabled or disabled.
Under the Assets Performance Testing Distribution section, you define the test distribution of images and PDFs as well as define your own test assets.
Images - Adjust the slider to adjust the test split between images and PDFs.
PDFs - Adjust the slider to adjust the test split between images and PDFs.
Define your own custom assets by uploading them.
Click Save to complete adding your production pipeline.
Once you have configured the pipeline, you need to deploy your code. Please see the document Code Deployment for more details.
This video provides an overview of the pipeline creation process, which is detailed in this document.