You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/overview/architecture.mdx
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,7 +10,7 @@ import CellRuntimeDiagram from '../resources/openchoreo-cell-runtime-view.png';
10
10
# OpenChoreo Architecture
11
11
OpenChoreo is architected as a modular, Kubernetes-native control plane that integrates deeply with other open-source projects to provide a comprehensive, extensible Internal Developer Platform (IDP).
12
12
13
-
The Control Plane acts as the orchestrator, transforming high-level platform and developer intent into actionable workloads deployed across Data planes, while wiring them into the Observability plane for visibility.
13
+
The Control Plane acts as the orchestrator, transforming high-level platform and developer intent into actionable workloads deployed across Data Planes, while wiring them into the Observability Plane for visibility.
14
14
15
15
The diagram below illustrates how these components interact.
16
16
@@ -26,12 +26,12 @@ Each plane in OpenChoreo operates as a distinct functional unit, with its own li
26
26
27
27
## Control Plane
28
28
29
-
The brain of OpenChoreo. It watches developer- and platform-defined CRDs, validates and processes them, and coordinates activities across other planes. It translates intent such as "deploy this component" or "connect these services" into concreteinfrastructure actions.
29
+
The brain of OpenChoreo. It watches developer- and platform-defined CRDs, validates and processes them, and coordinates activities across other planes. It translates intent such as "deploy this component" or "connect these services" into concrete infrastructure actions.
30
30
31
31
Responsibilities include:
32
32
• Validating CRD instances and resolving references (e.g., Connections between Components)
33
33
• Applying policy and environment-specific rules
34
-
• Coordinating CI jobs, deployments, and observability configs
34
+
• Coordinating CI jobs, deployments, and observability configurations
35
35
• Reconciling desired state with actual state across all planes
36
36
• Tracking the state of Components across environments and Data Planes
37
37
@@ -74,7 +74,7 @@ The Platform API enables platform engineers to configure the overall platform to
74
74
-**CI Plane**
75
75
- A Kubernetes cluster dedicated to running continuous integration (CI) jobs and pipelines.
76
76
-**Observability Plane**
77
-
- A Kubernetes cluster focused on collecting and analyzing telemetry data (logs, metrics, traces) from all other planes.
77
+
- A Kubernetes cluster focused on collecting and analyzing telemetry data (logs, metrics, and traces) from all other planes.
78
78
79
79
80
80
## Data Plane
@@ -105,7 +105,7 @@ In OpenChoreo, we refer to this namespace as a Cell — a secure, isolated, and
105
105
106
106
The CI Plane in OpenChoreo provides dedicated infrastructure for executing continuous integration workflows, separating build-time activities from runtime environments. It ensures that tasks such as source code compilation, container image creation, and test execution are performed in a secure, isolated, and scalable environment, without interfering with the application runtime.
107
107
108
-
By default, the CI Plane is powered by Argo Workflows, a Kubernetes-native workflow engine. However, OpenChoreo is designed to be flexible, you can customize the CI Plane to use an alternative engine like Tekton, depending on your organizational needs.
108
+
By default, the CI Plane is powered by Argo Workflows, a Kubernetes-native workflow engine. However, OpenChoreo is designed to be flexible, so you can customize the CI Plane to use an alternative engine like Tekton, depending on your organizational needs.
109
109
110
110
While tightly integrated, the CI Plane is an optional component. If you already have an existing CI system, such as GitHub Actions, GitLab CI, or Jenkins, you can continue to use it instead of OpenChoreo’s built-in CI. In this setup, OpenChoreo can ingest externally built container images and proceed with deployment and observability workflows as usual.
111
111
@@ -129,4 +129,4 @@ This view illustrates the full path from source code and platform configuration
129
129
OpenChoreo supports multiple deployment patterns to suit different organizational needs, from local development to large-scale, multi-cluster production setups.
130
130
- In development or testing setups, all planes can be deployed into a single Kubernetes cluster using namespace isolation.
131
131
- In production environments, each plane is typically deployed in a separate cluster for scalability, fault tolerance, and security.
132
-
- Hybrid topologies are also supported, allowing teams to colocate certain planes (e.g., Control + CI) for cost or operational efficiency.
132
+
- Hybrid topologies are also supported, allowing teams to co-locate certain planes (e.g., Control + CI) for cost or operational efficiency.
0 commit comments