Adding a pipeline on premises
When you add a pipeline on premises, you define all the stages and tasks that you want to do on each system. For example, if you are using branches, you can start a build when a branch is merged. If you are using a QA system, you can run test tasks to validate application data.
- Click .
- Click New.
- Specify the details of the application for which you are creating the pipeline.
- In the Development environment field, enter the
URL of the development system. This is the system on which the product rule that defines the application package that moves through the repository is located.
- In the Application field, press the Down arrow key and select the name of the application.
- In the Version field, press the Down arrow key and select the application version.
- In the Access group field, press the Down arrow
key and select the access group for which pipeline tasks are run.This access group must be present on all the candidate systems and have at least the sysadmin4 role.
- In the Pipeline name field, enter a unique name for the pipeline.
- In the Product rule field, enter the name of the product rule that defines the contents of the application.
- In the Version field, enter the product rule version.
- In the Development environment field, enter the
URL of the development system.
- If you are using a separate product rule to manage test cases, in the
Application test cases section, to deploy a test
case, select the Deploy test applications check box;
then, complete the following steps:
- In the Test application field, enter the name of the test application.
- In the Version field, enter the version of the test case product rule.
- In the Access group field, enter the access group for which test cases are run. Ensure that the access group is correctly pointing to the application name and version that is configured in the pipeline.
- In the Product rule field, enter the name of the test case product rule.
- From the Deploy until field, select the pipeline
stage until which the test case product rule will be deployed.When you use separate product rules for test cases and run a pipeline, the Run Pega unit tests, Enable test coverage, and Verify test coverage tasks are run for the access group that is specified in this section.
For the Run Pega scenario tests task, the user name that you provide should belong to the access group that is associated with the test application.
- To configure dependent applications, click
Dependencies.
- Click Add.
- In the Application name field, press the Down arrow key and select the application name.
- In the Pipeline field, press the Down arrow key and select the pipeline.
- In the Deployment field, press the Down arrow
key and select the deployment that contains the production-ready
artifact of the dependent application. If you want the latest artifact of the dependent application to be automatically populated, select latest.
For more information about dependent applications, see Managing application dependencies.For more information on updating existing dependencies, see Updating application dependencies in Deployment Manager.- Click Next.
- In the Environment details section, in the
Stages section, specify the URL of each candidate
system and the authentication profile that each system uses to communicate with
the orchestration system.
- In the Environments field for the system, press the Down arrow key and select the URL of the system.
- If you are using your own authentication profiles, in the Authentication field for the system, press the Down arrow key and select the authentication profile that you want to communicate from the orchestration server to the system.
By default, the fields are populated with the DMAppAdmin authentication profile. - In the Artifact management section, specify the development and production repositories through which the product rule that contains application contents moves through the pipeline.
- In the Development repository field, press the Down arrow key and select the development repository.
- In the Production repository field, press the Down arrow key and select the production repository.
- In the External orchestration server section, if you are
using a Jenkins step in a pipeline, specify the Jenkins details.
- In the URL field, enter the URL of the Jenkins server.
- In the Authentication profile field, press the Down arrow key and select the authentication profile on the orchestration server that specifies the Jenkins credentials to use for Jenkins jobs.
- Click Next.
- Specify whether you are using branches in your application.
- If you are not using branches, click the No radio button, and then go to step 14.
- If you are using branches, go to step 13.
- To specify branch options, do the following steps:
- Click the Yes radio button.
- Do one of the following options:
To merge branches into the highest existing ruleset in the application, click Highest existing ruleset.
To merge branches into a new ruleset, click New ruleset.
- In the Password field, enter the password that locks the rulesets on the development system.
- Click Next.
- To specify that a branch must meet a compliance score
before it can be merged:
- In the Merge criteria pane, click Add task.
- From the Task list, select Check guardrail compliance.
- In the Weighted compliance score field, enter the minimum required compliance score.
- Click Submit.
For more information about compliance scores, see Compliance score logic - To specify that a branch must be reviewed:
- In the Merge criteria pane, click Add task.
- From the Task list, select Check review status.
- Click Submit.
For more information about branch reviews, see Branch reviews. - To run Pega unit tests on the branches for the pipeline
application or for an application that is associated with an access group before
it can be merged:
- In the Merge criteria pane, click Add task.
- From the Task list, select Pega unit testing.
- To run all the Pega unit tests for an application that is associated with an access group, in the Access Group field, enter the access group.
- Click Submit. For more information about creating Pega unit tests, see Creating Pega unit test cases.
- To start a deployment automatically when a branch is
merged, click the Trigger deployment on merge check box. Do not select this check box if you want to manually start deployments. For more information, see Manually starting a deployment in Deployment Manager.
- Clear a check box for a deployment life cycle stage to skip it.
- In the Continuous Deployment
section, specify the tasks to be performed during each stage of the pipeline.
See the following topics for more information:
- Running Pega unit tests by adding the Run Pega unit tests task
- Running Jenkins steps by adding the Run Jenkins step task
- Specifying that an application meet a compliance score by adding the Check guardrail compliance score task
- Ensuring that the Application Security Checklist is completed by adding the Verify security checklist task
- Starting test coverage by adding the Enable test coverage task
- Stopping test coverage by adding the Validate test coverage task
- Running Pega scenario tests by adding the Run Pega scenario tests task
- Refreshing application quality by adding the Refresh application quality task
- Modifying the Approve for production task
- Clear the Production ready check
box if you do not want to generate an application package, which is sent to the
production repository. You cannot clear this check box if you are using a production stage in the life cycle.
- Click Finish.
- Run diagnostics to verify that your pipeline is
configured correctly. For more information, see Diagnosing a pipeline.
- Adding the Pega unit testing task
If you use Pega unit tests to validate application data, add the Pega unit testing task on the pipeline stage where you want to run it. For example, you can run Pega unit tests on a QA system.
- Adding the Jenkins task
If you are using Jenkins to perform tasks in your pipeline, you can add the Jenkins task to the stage on which you want it to run.
- Adding the manual step task
Use manual steps so that users must take an action before a pipeline deployment can continue. Users can either accept the task to continue the deployment or reject the task to stop it.
- Adding the Check guardrail compliance score task
You can use the Check guardrail compliance score task so that an application must meet a compliance score for the deployment to continue. The default value is 95, which you can modify.
- Starting another pipeline by adding the Trigger deployment task
You can start another pipeline by adding the Trigger deployment task to a stage in your current pipeline. By starting another pipeline from a current pipeline, you can add more stages to your pipeline.
- Adding the Verify security checklist task
For your pipeline to comply with security best practices, you can add a task so that to ensure that all the steps in Application Security Checklist are performed.
- Starting test coverage by adding the Enable test coverage task
Add the Enable test coverage task to start test coverage. Starting and stopping test coverage generates a report that identifies the executable rules in your application that are either covered or not covered by tests. As a best practice, to ensure application quality, you should test all the rules in your application for which testing is supported.
- Stopping test coverage by adding the Validate test coverage task
Add this task to stop a test coverage session. Starting and stopping test coverage generates a report that identifies the executable rules in your application that are either covered or not covered by tests. As a best practice, to ensure application quality, you should test all the rules in your application for which testing is supported.
- Running Pega scenario tests by adding the Run Pega scenario tests task
If you are using Pega scenario tasks, you can run them in your pipeline by using the Run Pega scenario tests task. Deployment Manager supports Selenium 3.141.59.
- Refreshing application quality by adding the Refresh application quality task
To refresh the Application Quality dashboard, which provides information about the health of your application, on the candidate system, add the Refresh application quality task. You can refresh the dashboard after running Pega unit tests, checking guardrail compliance, running Pega scenario tests, and starting or stopping test coverage.
- Modifying the Approve for production task
The Approve for production task is added to the stage before production. Use this task if you want a user to approve application changes before those changes are send to production.
Previous topic Adding a pipeline on Pega Cloud Services Next topic Running Pega unit tests by adding the Run Pega unit tests task