To learn how to configure CI/CD Pipeline for Cloud Manager in AEM as a Cloud Service, see here.
The following page explains how to configure the Pipeline. To review more conceptual information on how the pipeline works see the CI/CD pipeline overview.
The CI/CD Production Pipeline configuration defines the trigger that will initiate the pipeline, parameters controlling the production deployment and performance test parameters.
You can configure your pipeline from the Pipeline Settings tile in the Cloud Manager UI.
The Deployment Manager is responsible for setting up the pipeline. When doing so, you first select a branch from the Git Repository. Pipeline configuration consists of:
The pipeline cannot be setup until the Git repository has at least one branch and Program Setup is complete.
Before you start to deploy your code, you must configure your pipeline settings from the Cloud Manager.
You can change the pipeline settings after initial set up.
Once you have setup your program using Cloud Manager UI, you are ready to setup your pipeline.
Follow these steps to configure the behavior and preferences for your pipeline:
Click Setup Pipeline to setup and configure your pipeline.
The Setup Pipeline screen displays.
The three-step wizard allows you to setup your Branch, Environments, and Testing environment.
Select your Git branch and click Next.
Branches found in the Git repository are linked to your program.
Access the Environments tab to select Stage and Production options.
You can define the trigger to start the pipeline:
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 such as Code Quality, Security Testing, and Performance Testing.
This is useful for customers who have the desire for more automated processes. The available options are:
Ask every time - This is the default setting and requires manual intervention on any Important failure.
Cancel Immediately - If selected, the pipeline will be cancelled whenever an Important failure occurs. This is essentially emulating a user manually rejecting each failure.
Approve Immediately - If selected, the pipeline will proceed automatically whenever an Important failure occurs. This is essentially emulating a user manually approving each failure.
Now you define the parameters controlling the production deployment. The three available options are as follows:
Use Go Live Approval - A deployment must be manually approved by a business owner, project manager, or deployment manager via the Cloud Manager UI.
Use CSE Oversight - A CSE is engaged to actually start the deployment. During pipeline setup or edit when CSE Oversight is enabled, the Deployment Manager has the option of selecting:
Scheduled - This option allows the user to enable the scheduled production deployment.
If Scheduled option is selected, you can schedule your production deployment to the pipeline after the stage deployment (and Use GoLive Approval, if that has been enabled) to wait for a schedule to be set. The user can also choose to execute the production deployment immediately.
Please refer to Deploy your Code, to set the deployment schedule or execute the production immediately.
The Use CSE Oversight option is not available to all customers.
Approve after Stage Deployment
There is an optional step Approve after Stage Deployment which can be configured in the Production Pipeline.
This is enabled in a new option on the Pipeline Edit screen:
It is then shown as a separate step during pipeline execution:
Approve after Stage Deployment functions similarly to the approval before the production deployment, but occurs immediately after the stage deployment step,that is, before any testing is done, compared with the approval before the production deployment, which is done after all testing is complete.
As a Deployment Manager, you have the opportunity to configure a set of content paths which will either be invalidated or flushed from the AEM Dispatcher cache for publish instances, while setting up or editing pipeline.
You can configure a separate set of paths for Stage and Production deployment. If configured, 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 - invalidate performs a cache invalidation, similar to when content is activated from author to publish; flush performs a cache deletion.
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.
Please refer to Dispatcher Overview get more information on Dispatcher caching.
Follow the steps below to configure Dispatcher Invalidations:
Click Configure under the Dispatcher Configuration heading
Enter the path, select the action from Type, and click Add. You can specify up to 100 paths per environment. Once you have added the paths, click Apply.
Once you are back on the Pipeline Settings page, you will see an updated summary of the selections.
Click Save to persist this configuration.
Access the Testing tab to define your testing criteria for your program. You can now configure the performance test parameters.
You can configure AEM Sites and AEM Assets Performance Testing, depending on which products you have licensed. Refer to Performance Testing for more details.
Click Save to complete the setup of pipeline process.
Additionally, once you have setup the pipeline, you can still edit settings for the same using Production Pipeline Settings tile from the Cloud Manager UI.
In addition to the main pipeline which deploys to stage and production, customers are able to set up additional pipelines, referred to as Non-Production Pipelines. These pipelines always execute the build and code quality steps. They can optionally also deploy to Adobe Managed Services environment.
CI/CD Non-production pipelines are broken into two categories, Code Quality pipelines, and Deployment pipelines. Code Quality pipelines all code from a Git branch to build and be evaluated against Cloud Manager’s code quality scan.
On the home screen, these pipelines are listed in a new card:
Access the Non-Production Pipelines tile from the Cloud Manager home screen.
Clicking on the Add button, to specify the Pipeline Name, Pipeline Type, and the Git Branch.
Additionally, you can also set up Deployment Trigger and Important Failure Behavior from Pipeline Options.
Click Save and the pipeline is shown on the card on the home screen with three actions:
While the pipeline is running, the current step is displayed and only the Details action is available.
Once you have configured the pipeline, you need to deploy your code.
Please see Deploy your Code for more details.