Close popover

Table of Contents

Adding a pipeline on-premises

Version:

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.

To add a pipeline on premises, complete the following steps:

  1. In the Designer Studio footer, click Deployment Manager.

  2. Click Add pipeline.

  3. Specify the details of the application for which you are creating the pipeline.

    1. 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.

    2. In the Application field, press the Down arrow key and select the name of the application.

    3. In the Version field, press the Down arrow key and select the application version.

    4. 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.

    5. In the Pipeline name field, enter a unique name for the pipeline.

    6. In the Product rule field, enter the name of the product rule that defines the contents of the application.

    7. In the Version field, enter the product rule version.

  4. To configure dependent applications, click Dependencies.

    1. Click Add.

    2. In the Application name field, press the Down arrow key and select the application name.

    3. In the Application version field, press the Down arrow key and select the application version.

    4. In the Repository name field, press the Down arrow key and select the repository that contains the production-ready artifact of the dependent application.

      If you want the latest artifact of the dependent application to be automatically populated, ensure that the repository that contains the production-ready artifact of the dependent application is configured to support file updates.

    5. In the Artifact name field, press the Down arrow key and select the artifact.

    For more information about dependent applications, see Product rules: Listing product dependencies for Pega-supplied applications.

    1. Click Next.

  5. 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.

    1. In the Environments field for the system, press the Down arrow key and select the URL of the system.

    2. 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.

  6. In the Artifact management section, specify the development and production repositories through which the product rule that contains application contents moves through the pipeline.

  7. In the Development repository field, press the Down arrow key and select the development repository.

  8. In the Production repository field, press the Down arrow key and select the production repository.

  9. In the External orchestration server section, if you are using a Jenkins step in a pipeline, specify the Jenkins details.

    1. In the URL field, enter the URL of the Jenkins server.

    2. 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.

  10. Click Next.

  11. If you are using branches in your application, in the Merge policy section, specify merge options. Do one of the following actions:

    • 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.
  12. In the Password field, enter the password that locks the rulesets on the development system.

  13. Click Next.

    The system adds tasks, which you cannot delete, to the pipeline that are required to successfully run a workflow, for example, Deploy and Generate Artifact. The system also adds other tasks to enforce best practices such as Check guardrail compliance and Verify security checklist.
  14. To specify that a branch must meet a compliance score before it can be merged:

    1. In the Merge criteria pane, click Add task.

    2. From the Task list, select Check guardrail compliance.

    3. In the Weighted compliance score field, enter the minimum required compliance score.

    4. Click Submit.

    For more information about compliance scores, see Compliance score logic

  15. To specify that a branch must be reviewed before it can be merged:

    1. In the Merge criteria pane, click Add task.

    2. From the Task list, select Check review status.

    3. Click Submit.

    For more information about branch reviews, see Branch reviews.

  16. 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.

  17. Clear a check box for a deployment life cycle stage to skip it.

  18. In the Continuous Deployment section, specify the tasks to be performed during each stage of the pipeline. See the following topics for more information:

  19. Click Finish.

Suggest Edit

Have a question? Get answers now.

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