Runtime Cloud — microservices¶
Generated from the architecture model
This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.
Every logical service keeps its own design page and model entry; deployment granularity says how it is shipped at first (decision D23). Modules of a host are deployed inside that host until an extraction decision is recorded.
flowchart TB
subgraph RuntimeCloudHost["RuntimeCloudHost (host)"]
AgentPoolManager["AgentPoolManager"]
DeploymentManifestService["DeploymentManifestService"]
DeploymentService["DeploymentService"]
GitOpsSyncService["GitOpsSyncService"]
IaCProvisioningService["IaCProvisioningService"]
ExecutionCapacityService["ExecutionCapacityService"]
RuntimeDriftDetectionService["RuntimeDriftDetectionService"]
RuntimeEnvironmentService["RuntimeEnvironmentService"]
RuntimeScalingService["RuntimeScalingService"]
ServiceCatalogRuntimeService["ServiceCatalogRuntimeService"]
end
RuntimeConfigurationService[("RuntimeConfigurationService<br/>external")]
classDef later stroke-dasharray: 4 4;| Service | Context | Granularity | Host | Status | Page |
|---|---|---|---|---|---|
| AgentPoolManager | BC-26 | module of host | RuntimeCloudHost | unmodelled | — |
| DeploymentManifestService | BC-25 | module of host | RuntimeCloudHost | unmodelled | — |
| DeploymentService | BC-25 | module of host | RuntimeCloudHost | unmodelled | — |
| GitOpsSyncService | BC-25 | module of host | RuntimeCloudHost | unmodelled | — |
| IaCProvisioningService | BC-25 | module of host | RuntimeCloudHost | target | design |
| RuntimeCloudHost | BC-25 | standalone host | — | target | design |
| ExecutionCapacityService | BC-26 | module of host | RuntimeCloudHost | target | design |
| RuntimeConfigurationService | BC-25 | external / canonical | — | unmodelled | — |
| RuntimeDriftDetectionService | BC-25 | module of host | RuntimeCloudHost | unmodelled | — |
| RuntimeEnvironmentService | BC-25 | module of host | RuntimeCloudHost | target | design |
| RuntimeScalingService | BC-26 | module of host | RuntimeCloudHost | unmodelled | — |
| ServiceCatalogRuntimeService | BC-25 | module of host | RuntimeCloudHost | unmodelled | — |
AgentPoolManager¶
Agent worker pools; merged into ExecutionCapacityService.
| Bounded context | BC-26 Execution Capacity |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | Control Plane (merge) |
| Status | unmodelled |
| Design page | not written yet |
DeploymentManifestService¶
Deployment manifests; merged into IaCProvisioningService as deployment specifications.
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | DevOps / GitOps (merge) |
| Status | unmodelled |
| Design page | not written yet |
DeploymentService¶
Deployment execution; merged into IaCProvisioningService as provisioning runs.
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | Runtime Cloud (merge) |
| Status | unmodelled |
| Design page | not written yet |
GitOpsSyncService¶
GitOps synchronisation; merged into IaCProvisioningService as the reconciler.
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | DevOps / GitOps (merge) |
| Status | unmodelled |
| Design page | not written yet |
IaCProvisioningService¶
Desired-state specifications in Git, plan and apply receipts from the IaC runner, production applies under the promotion's approval, GitOps reconciliation (BC-25).
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | DevOps / GitOps (module) |
| Status | target |
| Modelled | 2 aggregates · 5 REST + 1 gRPC · 4 events · 3 workers · 2 tables |
| Design page | planes/execution/environments/services/ia-c-provisioning-service/index.md |
RuntimeCloudHost¶
Provisioning, reconciliation and execution capacity host.
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | standalone host |
| Former catalog group | (host added 2026-10-09) (module) |
| Status | target |
| Modelled | 0 aggregates · 2 REST + 0 gRPC · 0 events · 0 workers · 0 tables |
| Design page | planes/execution/environments/services/runtime-cloud-host/index.md |
ExecutionCapacityService¶
Worker pools, quotas per edition and capacity leases for attempts, sandboxes, builds and browser sessions (BC-26).
| Bounded context | BC-26 Execution Capacity |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | (added 2026-10-09, design plan P11) (module) |
| Status | target |
| Modelled | 3 aggregates · 5 REST + 3 gRPC · 5 events · 2 workers · 3 tables |
| Design page | planes/execution/environments/services/execution-capacity-service/index.md |
RuntimeConfigurationService¶
Config Platform (canonical documentation)
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | external / canonical · ref ext-config-platform |
| Former catalog group | Runtime Cloud (external) |
| Status | unmodelled |
| Design page | not written yet |
RuntimeDriftDetectionService¶
Drift detection; merged into RuntimeEnvironmentService.
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | Runtime Cloud (merge) |
| Status | unmodelled |
| Design page | not written yet |
RuntimeEnvironmentService¶
Observed-state inventory, drift findings and reviewable reconciliation proposals (BC-25).
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | Runtime Cloud (module) |
| Status | target |
| Modelled | 3 aggregates · 5 REST + 1 gRPC · 4 events · 2 workers · 4 tables |
| Design page | planes/execution/environments/services/runtime-environment-service/index.md |
RuntimeScalingService¶
Scaling; merged into ExecutionCapacityService as pool autoscaling.
| Bounded context | BC-26 Execution Capacity |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | Runtime Cloud (merge) |
| Status | unmodelled |
| Design page | not written yet |
ServiceCatalogRuntimeService¶
Observed-state projection; merged into RuntimeEnvironmentService as the runtime inventory.
| Bounded context | BC-25 Provisioning & Reconciliation |
| Granularity | module of host · host RuntimeCloudHost |
| Former catalog group | Runtime Cloud (merge) |
| Status | unmodelled |
| Design page | not written yet |