# forgerock/forgeops architecture

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

- Interactive diagram: https://gitdiagram.com/forgerock/forgeops
- Repository: https://github.com/forgerock/forgeops

## Overview

ForgeOps is a Kubernetes deployment toolkit for Ping Advanced Identity Software. The main workflow is an operator using the ForgeOps tooling and deployment artifacts to configure and deploy the identity platform; the README identifies Docker, Kustomize, and Helm as supported deployment formats. The repository also includes Gatling simulations for benchmarking authentication and other platform workloads. Edges reflect README statements or shown source references; unsampled deployment wiring is not inferred.

Main entry points: [`kustomize`](https://github.com/forgerock/forgeops/tree/main/kustomize) (Kustomize Overlays), [`charts/identity-platform/templates`](https://github.com/forgerock/forgeops/tree/main/charts/identity-platform/templates) (Helm Charts), [`bin/forgeops`](https://github.com/forgerock/forgeops/blob/main/bin/forgeops) (ForgeOps CLI), [`docker/ig`](https://github.com/forgerock/forgeops/tree/main/docker/ig) (PingGateway)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Deployment Operations"]
  node_forgeops["ForgeOps CLI"]
  node_upgrade["Environment Upgrade<br/>[env_upgrade.py]"]
  node_shared["Python Utilities<br/>[common.py]"]
  node_release["Release Selection<br/>[releases.py]"]
  node_defaults["Deployment Defaults<br/>[defaults.py]"]
end

subgraph group_artifacts["Platform Artifacts"]
  node_helm["Helm Charts"]
  node_kustomize["Kustomize Overlays"]
  node_docker["Service Images"]
  node_gatewaychart["Gateway Chart"]
end

subgraph group_identity["Identity Services"]
  node_am["PingAM"]
  node_idm["PingIDM"]
  node_ds[("PingDS")]
  node_gateway["PingGateway"]
end

subgraph group_benchmark["Load Testing"]
  node_benchmark["Gatling Scenarios"]
  node_login["Authentication Load<br/>[Login.scala]"]
  node_benchconfig["Benchmark Config<br/>[util.scala]"]
end

node_operator(("Platform Operator"))
node_amendpoint(("PingAM Endpoint"))

node_operator -->|"runs tooling"| node_forgeops
node_forgeops -->|"deploys with"| node_helm
node_forgeops -->|"deploys with"| node_kustomize
node_forgeops -->|"uses images"| node_docker
node_upgrade -->|"writes YAML"| node_shared
node_upgrade -->|"updates overlays"| node_kustomize
node_release -->|"uses defaults"| node_defaults
node_helm -->|"deploys"| node_am
node_helm -->|"deploys"| node_idm
node_helm -->|"deploys"| node_ds
node_helm -.->|"optionally deploys"| node_gateway
node_kustomize -->|"deploys"| node_am
node_kustomize -->|"deploys"| node_idm
node_kustomize -->|"deploys"| node_ds
node_kustomize -.->|"optionally deploys"| node_gateway
node_gatewaychart -->|"deploys"| node_gateway
node_login -->|"uses config"| node_benchconfig
node_login -->|"sends auth requests"| node_amendpoint

click node_forgeops "https://github.com/forgerock/forgeops/blob/main/bin/forgeops"
click node_upgrade "https://github.com/forgerock/forgeops/blob/main/bin/commands/env_upgrade.py"
click node_shared "https://github.com/forgerock/forgeops/blob/main/lib/python/common.py"
click node_release "https://github.com/forgerock/forgeops/blob/main/lib/python/releases.py"
click node_defaults "https://github.com/forgerock/forgeops/blob/main/lib/python/defaults.py"
click node_helm "https://github.com/forgerock/forgeops/tree/main/charts/identity-platform/templates"
click node_kustomize "https://github.com/forgerock/forgeops/tree/main/kustomize"
click node_docker "https://github.com/forgerock/forgeops/tree/main/docker"
click node_am "https://github.com/forgerock/forgeops/tree/main/docker/am"
click node_idm "https://github.com/forgerock/forgeops/tree/main/docker/idm"
click node_ds "https://github.com/forgerock/forgeops/tree/main/docker/ds"
click node_gateway "https://github.com/forgerock/forgeops/tree/main/docker/ig"
click node_gatewaychart "https://github.com/forgerock/forgeops/tree/main/charts/ping-gateway"
click node_benchmark "https://github.com/forgerock/forgeops/tree/main/docker/gatling/src/gatling/simulations"
click node_login "https://github.com/forgerock/forgeops/blob/main/docker/gatling/src/gatling/simulations/platform/Login.scala"
click node_benchconfig "https://github.com/forgerock/forgeops/blob/main/docker/gatling/src/gatling/simulations/util.scala"

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_forgeops,node_upgrade,node_shared,node_release,node_defaults toneBlue
class node_helm,node_kustomize,node_docker,node_gatewaychart toneAmber
class node_am,node_idm,node_ds,node_gateway toneMint
class node_benchmark,node_login,node_benchconfig toneRose
class node_operator,node_amendpoint toneIndigo
```

## Components

### Deployment Operations

- [ForgeOps CLI](https://github.com/forgerock/forgeops/blob/main/bin/forgeops): `bin/forgeops`
- [Environment Upgrade](https://github.com/forgerock/forgeops/blob/main/bin/commands/env_upgrade.py): `bin/commands/env_upgrade.py`
- [Python Utilities](https://github.com/forgerock/forgeops/blob/main/lib/python/common.py): `lib/python/common.py`
- [Release Selection](https://github.com/forgerock/forgeops/blob/main/lib/python/releases.py): `lib/python/releases.py`
- [Deployment Defaults](https://github.com/forgerock/forgeops/blob/main/lib/python/defaults.py): `lib/python/defaults.py`

### Platform Artifacts

- [Helm Charts](https://github.com/forgerock/forgeops/tree/main/charts/identity-platform/templates): `charts/identity-platform/templates`
- [Kustomize Overlays](https://github.com/forgerock/forgeops/tree/main/kustomize): `kustomize`
- [Service Images](https://github.com/forgerock/forgeops/tree/main/docker): `docker`
- [Gateway Chart](https://github.com/forgerock/forgeops/tree/main/charts/ping-gateway): `charts/ping-gateway`

### Identity Services

- [PingAM](https://github.com/forgerock/forgeops/tree/main/docker/am): `docker/am`
- [PingIDM](https://github.com/forgerock/forgeops/tree/main/docker/idm): `docker/idm`
- [PingDS](https://github.com/forgerock/forgeops/tree/main/docker/ds): `docker/ds`
- [PingGateway](https://github.com/forgerock/forgeops/tree/main/docker/ig): `docker/ig`

### Load Testing

- [Gatling Scenarios](https://github.com/forgerock/forgeops/tree/main/docker/gatling/src/gatling/simulations): `docker/gatling/src/gatling/simulations`
- [Authentication Load](https://github.com/forgerock/forgeops/blob/main/docker/gatling/src/gatling/simulations/platform/Login.scala): `docker/gatling/src/gatling/simulations/platform/Login.scala`
- [Benchmark Config](https://github.com/forgerock/forgeops/blob/main/docker/gatling/src/gatling/simulations/util.scala): `docker/gatling/src/gatling/simulations/util.scala`

### Other components

- **Platform Operator**
- **PingAM Endpoint**

## Connections

- Platform Operator → ForgeOps CLI: runs tooling (evidence: `README.md`)
- ForgeOps CLI → Helm Charts: deploys with (evidence: `README.md`)
- ForgeOps CLI → Kustomize Overlays: deploys with (evidence: `README.md`)
- ForgeOps CLI → Service Images: uses images (evidence: `README.md`)
- Environment Upgrade → Python Utilities: writes YAML (evidence: `bin/commands/env_upgrade.py`)
- Environment Upgrade → Kustomize Overlays: updates overlays (evidence: `bin/commands/env_upgrade.py`)
- Release Selection → Deployment Defaults: uses defaults (evidence: `lib/python/releases.py`)
- Helm Charts → PingAM: deploys (evidence: `README.md`)
- Helm Charts → PingIDM: deploys (evidence: `README.md`)
- Helm Charts → PingDS: deploys (evidence: `README.md`)
- Helm Charts → PingGateway: optionally deploys (evidence: `README.md`)
- Kustomize Overlays → PingAM: deploys (evidence: `README.md`)
- Kustomize Overlays → PingIDM: deploys (evidence: `README.md`)
- Kustomize Overlays → PingDS: deploys (evidence: `README.md`)
- Kustomize Overlays → PingGateway: optionally deploys (evidence: `README.md`)
- Gateway Chart → PingGateway: deploys (evidence: `README.md`)
- Authentication Load → Benchmark Config: uses config (evidence: `docker/gatling/src/gatling/simulations/platform/Login.scala`)
- Authentication Load → PingAM Endpoint: sends auth requests (evidence: `docker/gatling/src/gatling/simulations/platform/Login.scala`)
