looking for GITLAB CI/CD documentation

General
, , , , ,
1

Hello Team,

I am looking for Gitlab CI/CD documentation for our pega application

2

Hello Team ,

can anyone help me to get Gitlab CI/CD documentation as soon as possible?

we’re planning Orchestrate Pega Deployments using Gitlab CI/CD and Due to some org security reasons we are looking Gitlab CI/CD .Not going with PEGA DEPLOYMENT MANAGER

3

@purellaS16594611 :warning: Below is a GenAI-powered answer.

All generated answers require validation against the provided references.

References:
GitLab CI/CD Documentation
Pega DevOps Architecture
Release Management with Pega Platform

1. GitLab CI/CD Setup Documentation

The primary documentation for GitLab CI/CD can be found at GitLab’s official documentation. To get started immediately:

  1. Create a .gitlab-ci.yml file in your repository root
  2. Define your pipeline stages and jobs
  3. Configure GitLab runners for executing the pipeline

2. Deployment Pipeline Structure

I’ve created a diagram showing the recommended GitLab CI/CD pipeline structure for Pega deployments:

ear.png
ear.png228×600 6.77 KB

3. Key Implementation Steps

a) Pipeline Configuration

  • Set up environment-specific variables in GitLab
  • Configure secure credential management
  • Define quality gates and security checks

b) Deployment Automation

  • Package application artifacts
  • Implement automated testing
  • Set up environment-specific deployments
  • Configure rollback procedures

c) Security Considerations

  • Use GitLab’s secret variables for sensitive data
  • Implement environment-specific access controls
  • Set up audit logging for deployment actions
  • Configure security scanning in the pipeline

4. Pega-Specific Configuration

While not using Pega Deployment Manager, you’ll still need to:

  • Configure artifact repository management
  • Set up branch merging automation
  • Implement guardrail compliance checks
  • Configure test coverage enforcement

5. Required Documentation Links

  1. GitLab CI/CD Quick Start
  2. Pipeline Configuration Reference
  3. GitLab CI/CD Variables
  4. Security Best Practices
4

@MarijeSchillern Hello

Do we need any specific file locations for pega to implement Gitlab ci cd deployment?

5

@purellaS16594611 from our GenAI bot:

Below the essential file locations and structure requirements:

Required File Locations

  1. Root Configuration File
    • The .gitlab-ci.yml file must be placed in the root directory of your repository
    • This is the primary configuration file that GitLab uses to manage your CI/CD pipeline
  2. Pega Application Files
    • Place your Pega application files in a dedicated /pega directory within your repository
    • Organize deployment configurations in a /deploy subdirectory
    • Store environment-specific variables in /deploy/environments
  3. Pipeline Configuration Files
  4. repository-root/
  5. ├── .gitlab-ci.yml
  6. ├── pega/
  7. │ ├── application/
  8. │ └── rules/
  9. ├── deploy/
  10. │ ├── environments/
  11. │ │ ├── dev/
  12. │ │ ├── staging/
  13. │ │ └── prod/
  14. │ └── scripts/
  15. └── tests/

Important Considerations

  1. Artifact Storage
    • Configure artifact storage in your GitLab settings
    • Use the built-in GitLab artifact registry or an external artifact repository
    • Ensure the pipeline has appropriate access permissions to artifact storage locations
  2. Security Files
    • Store security credentials as GitLab CI/CD variables, not in repository files
    • Place security scanning configurations in .gitlab/security/ directory
    • Keep authentication tokens and sensitive data in GitLab’s protected variables
  3. Temporary Files
    • GitLab runners use temporary storage during pipeline execution
    • Don’t rely on persistent storage in pipeline jobs
    • Use GitLab artifacts for passing files between pipeline stages

Remember that when transitioning from Pega Deployment Manager, you’ll need to ensure your file structure accommodates both your existing Pega deployment requirements and GitLab CI/CD best practices.

References:

6

@purellaS16594611 From our GenAI bot:

Regarding your first question about whether Pega Deployment Manager is required to automate CI/CD in on-premises environments: While Pega Deployment Manager is not explicitly required, it is the standard tool provided by Pega for automating DevOps workflows, including CI/CD for Pega applications. It provides a low-code, model-driven experience to configure and run continuous integration and delivery workflows. Deployment Manager is designed to expose all the capabilities of Pega Platform necessary for automating DevOps workflows, including branch merging, application packaging, applying quality gates, and promoting applications to different environments.

As for your second question about licensing: you should speak to your Pega Account Executive about this.

I believe that Pega Deployment Manager is included in the standard Pega license for on-premises environments, but you will need to check.

For on-premises deployments, you have several options:

  1. Running the open-source version
  2. Using a solution from a third party
  3. Getting the service through a partner that will run a third-party solution

If your organization already has an enterprise license for a third-party product that can serve this purpose, you can set up an instance dedicated to supporting your Pega applications, provided that the terms of your agreement permit it.

References:

7

@MarijeSchillernAnyway we should require Pega Deployment Manager to automate CI/CD on premises environment rigth?

Does Pega Deployment Manager comes under pega license or do we need to pay extra for this?