Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Best practices for merge pipelines

Updated on July 14, 2022

During parallel application development, developers make changes and configurations that they need to frequently integrate with updates from other developers.

These changes need to meet the following requirements:

  • Meet quality standards
  • Be compatible with existing functionality
  • Not conflict with a developer's application changes.
To meet these criteria, developers work in branches and merge their changes to the base application.

Use merge pipelines to merge branches into the base application. The system starts a merge only after validating branch changes against the quality gates, such as guardrails, branch reviews, and automated tests, which you configured on the pipeline. If the merge criteria are met, the system merges the branches. If any quality gates fail, the system rejects the merge request, and then notifies you about the failure.

The following figure shows the branch tasks that are available on the Development environment for a merge pipeline.

Branch tasks in the merge pipeline
List of branch tasks that you can use in a merge pipeline

You can use the following tasks in a merge pipeline:

Tasks for a merge pipeline

Task Definition Notes
Get merge conflict Examines the rule conflicts for a specified branch of the base rule and reports an error if the branch rule conflicts with the base rule. In the Conflicts and Warnings window in the Merge wizard, review and fix merge conflicts before you merge branches. For more information, see Conflicts and warnings in the Merge Branches wizard.
Check branch guardrail Verifies that the guardrail weighted score meets a compliance score of 90 percent, which indicates a high performing application. The system calculates the weighted score by comparing guardrail warnings, weighted by severity and justification, against the total number of rules in the branch. Ensure that the score is 90 percent to continuously improve the quality of development. In addition to this check, validate that your development standards can enforce specific warnings and block the merge.

For more information, see Improving your compliance score.

Monitor the number and severity of guardrail violations that the system found in your branch. By investigating and resolving the violations, you can improve your the overall quality of your branch.
Validate development standards Validates if the rules in a branch meet the guardrail warnings that you have specified in a policy.

A default policy is available for users to use. This policy defines the high value guardrail warnings that must be enforced to reduce the risk of performance and security issues in Pega Platform or Pega application updates. This also helps you maintain an efficient, sustainable, and guardrail compliant application. For more information, see Managing development standards.

To assist you with using this task, you can:
  • Review the guardrail warnings recommended in the default policy and customize the policy as needed.
  • Comply with the default warnings and use the additional warnings to further enforce guardrail warnings.
  • Use the Validate from task if you want to enforce the guardrails on rules that were created after a specified date.
Run Pega units on branch Validates your functionality by running Pega unit tests.

The task can run Pega unit tests from a test application or from the application that is specified in the access group that the system supplies to the task.

The task fails if the pass percentage is not 100 percent.

Check rule overrides Validates if the rules in the branch include overrides to final rules.

This task ensures that the system does not override any internal rules during branch merges, which helps control maintenance issues with new Pega Platform updates.

Using this task results in an error if you override any Pega- provided rule that you cannot extend in the application.

  • Previous topic Best practices for using pipelines in Deployment Manager
  • Next topic Best practices for deployment pipelines

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us