# pegasystems/pega-helm-charts architecture

> Architecture diagram of the GitHub repository pegasystems/pega-helm-charts, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/pegasystems/pega-helm-charts
- Repository: https://github.com/pegasystems/pega-helm-charts

## Overview

This repository packages Helm charts for deploying Pega Infinity and supporting Kubernetes services. The documented workflow is to configure chart values, deploy backing services and environment-specific add-ons, then install Pega into its namespace. The tree identifies chart components such as the installer, application tier, clustering, and search, but no source excerpts were provided; relationships inside those charts are therefore omitted. The README describes deployment responsibilities and order, not the implementation details of each template.

Main entry points: [`charts/pega`](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/pega) (Pega chart), [`charts/backingservices`](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices) (Backing services), [`charts/pega/values.yaml`](https://github.com/pegasystems/pega-helm-charts/blob/master/charts/pega/values.yaml) (Chart values), [`charts/addons`](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/addons) (Environment add-ons)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_deploy["Deployment flow"]
  node_values["Chart values<br/>[values.yaml]"]
end

subgraph group_support["Supporting services"]
  node_addons["Environment add-ons"]
  node_backing["Backing services"]
  node_srs["Search and Reporting"]
  node_constellation["Constellation services"]
  node_messaging["Messaging service"]
  node_autopilot["Autopilot service"]
end

subgraph group_platform["Pega platform"]
  node_pega["Pega chart"]
  node_installer["Installer job"]
  node_application["Pega application tier"]
  node_clustering["Clustering services"]
  node_search["Search services"]
end

subgraph group_infra["Cluster dependencies"]
  node_database[("Relational database")]
  node_kubernetes["Kubernetes cluster"]
end

node_operator(("Deployment operator"))
node_helm["Helm"]

node_operator -->|"runs charts"| node_helm
node_operator -->|"configures"| node_values
node_helm -->|"installs"| node_backing
node_helm -->|"installs"| node_addons
node_helm -->|"installs"| node_pega
node_backing -.->|"includes"| node_srs
node_backing -.->|"includes"| node_constellation
node_backing -.->|"includes"| node_messaging
node_backing -.->|"includes"| node_autopilot
node_pega -.->|"configures"| node_installer
node_pega -.->|"deploys"| node_application
node_pega -.->|"configures"| node_clustering
node_pega -.->|"configures"| node_search
node_pega -->|"uses"| node_database
node_pega -->|"configures endpoints"| node_backing
node_helm -->|"targets"| node_kubernetes

click node_values "https://github.com/pegasystems/pega-helm-charts/blob/master/charts/pega/values.yaml"
click node_addons "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/addons"
click node_backing "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices"
click node_srs "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/srs"
click node_constellation "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/constellation"
click node_messaging "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/constellation-messaging"
click node_autopilot "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/autopilot"
click node_pega "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/pega"
click node_installer "https://github.com/pegasystems/pega-helm-charts/blob/master/charts/pega/charts/installer/templates/pega-installer-job.yaml"
click node_application "https://github.com/pegasystems/pega-helm-charts/blob/master/charts/pega/templates/_pega-deployment.tpl"
click node_clustering "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/pega/charts/hazelcast"
click node_search "https://github.com/pegasystems/pega-helm-charts/tree/master/charts/pega/charts/pegasearch"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_values toneBlue
class node_addons,node_backing,node_srs,node_constellation,node_messaging,node_autopilot toneAmber
class node_pega,node_installer,node_application,node_clustering,node_search toneMint
class node_database,node_kubernetes toneRose
class node_operator,node_helm toneIndigo
```

## Components

### Deployment flow

- [Chart values](https://github.com/pegasystems/pega-helm-charts/blob/master/charts/pega/values.yaml): `charts/pega/values.yaml`

### Supporting services

- [Environment add-ons](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/addons): `charts/addons`
- [Backing services](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices): `charts/backingservices`
- [Search and Reporting](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/srs): `charts/backingservices/charts/srs`
- [Constellation services](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/constellation): `charts/backingservices/charts/constellation`
- [Messaging service](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/constellation-messaging): `charts/backingservices/charts/constellation-messaging`
- [Autopilot service](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/backingservices/charts/autopilot): `charts/backingservices/charts/autopilot`

### Pega platform

- [Pega chart](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/pega): `charts/pega`
- [Installer job](https://github.com/pegasystems/pega-helm-charts/blob/master/charts/pega/charts/installer/templates/pega-installer-job.yaml): `charts/pega/charts/installer/templates/pega-installer-job.yaml`
- [Pega application tier](https://github.com/pegasystems/pega-helm-charts/blob/master/charts/pega/templates/_pega-deployment.tpl): `charts/pega/templates/_pega-deployment.tpl`
- [Clustering services](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/pega/charts/hazelcast): `charts/pega/charts/hazelcast`
- [Search services](https://github.com/pegasystems/pega-helm-charts/tree/master/charts/pega/charts/pegasearch): `charts/pega/charts/pegasearch`

### Cluster dependencies

- **Relational database**
- **Kubernetes cluster**

### Other components

- **Deployment operator**
- **Helm**

## Connections

- Deployment operator → Helm: runs charts (evidence: `README.md`)
- Deployment operator → Chart values: configures (evidence: `README.md`)
- Helm → Backing services: installs (evidence: `README.md`)
- Helm → Environment add-ons: installs (evidence: `README.md`)
- Helm → Pega chart: installs (evidence: `README.md`)
- Backing services → Search and Reporting: includes
- Backing services → Constellation services: includes
- Backing services → Messaging service: includes
- Backing services → Autopilot service: includes
- Pega chart → Installer job: configures
- Pega chart → Pega application tier: deploys
- Pega chart → Clustering services: configures
- Pega chart → Search services: configures
- Pega chart → Relational database: uses (evidence: `README.md`)
- Pega chart → Backing services: configures endpoints (evidence: `README.md`)
- Helm → Kubernetes cluster: targets (evidence: `README.md`)