DevOps / GitOps — 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 DeliveryHost["DeliveryHost (host)"]
BuildResultService["BuildResultService"]
ContainerImageService["ContainerImageService"]
EnvironmentPromotionService["EnvironmentPromotionService"]
PipelineExecutionService["PipelineExecutionService"]
ReleaseService["ReleaseService"]
end
BranchService[("BranchService<br/>external")]
CommitService[("CommitService<br/>external")]
PackagePublisherService[("PackagePublisherService<br/>external")]
PackagePublishingService[("PackagePublishingService<br/>external")]
PullRequestService[("PullRequestService<br/>external")]
RepositoryService[("RepositoryService<br/>external")]
TemplatePublishingService[("TemplatePublishingService<br/>external")]
classDef later stroke-dasharray: 4 4;| Service | Context | Granularity | Host | Status | Page |
|---|---|---|---|---|---|
| BranchService | BC-23 | external / canonical | — | unmodelled | — |
| BuildResultService | BC-23 | module of host | DeliveryHost | unmodelled | — |
| CommitService | BC-23 | external / canonical | — | unmodelled | — |
| ContainerImageService | BC-24 | module of host | DeliveryHost | unmodelled | — |
| DeliveryHost | BC-23 | standalone host | — | target | design |
| EnvironmentPromotionService | BC-24 | module of host | DeliveryHost | target | design |
| PackagePublisherService | BC-24 | external / canonical | — | unmodelled | — |
| PackagePublishingService | BC-24 | external / canonical | — | unmodelled | — |
| PipelineExecutionService | BC-23 | module of host | DeliveryHost | target | design |
| PullRequestService | BC-23 | external / canonical | — | unmodelled | — |
| ReleaseService | BC-24 | module of host | DeliveryHost | target | design |
| RepositoryService | BC-23 | external / canonical | — | unmodelled | — |
| TemplatePublishingService | BC-24 | external / canonical | — | unmodelled | — |
BranchService¶
Azure DevOps / GitHub are the system of record; the Factory keeps receipts via connectors (BC-17)
| Bounded context | BC-23 Source & Pipelines |
| Granularity | external / canonical · ref ext-azure-devops |
| Former catalog group | DevOps / GitOps (external) |
| Status | unmodelled |
| Design page | not written yet |
BuildResultService¶
Build and test results; merged into PipelineExecutionService as typed pipeline results.
| Bounded context | BC-23 Source & Pipelines |
| Granularity | module of host · host DeliveryHost |
| Former catalog group | DevOps / GitOps (merge) |
| Status | unmodelled |
| Design page | not written yet |
CommitService¶
Azure DevOps / GitHub are the system of record; the Factory keeps receipts via connectors (BC-17)
| Bounded context | BC-23 Source & Pipelines |
| Granularity | external / canonical · ref ext-azure-devops |
| Former catalog group | DevOps / GitOps (external) |
| Status | unmodelled |
| Design page | not written yet |
ContainerImageService¶
Container images; merged into ReleaseService as release components.
| Bounded context | BC-24 Package & Release Delivery |
| Granularity | module of host · host DeliveryHost |
| Former catalog group | DevOps / GitOps (merge) |
| Status | unmodelled |
| Design page | not written yet |
DeliveryHost¶
Pipeline, build and release receipt host.
| Bounded context | BC-23 Source & Pipelines |
| 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/delivery-engine/services/delivery-host/index.md |
EnvironmentPromotionService¶
Gated promotions into environment classes with production approvals, desired-state hand-off to provisioning, verification and rollback (BC-24).
| Bounded context | BC-24 Package & Release Delivery |
| Granularity | module of host · host DeliveryHost |
| Former catalog group | DevOps / GitOps (module) |
| Status | target |
| Modelled | 1 aggregates · 5 REST + 1 gRPC · 5 events · 2 workers · 2 tables |
| Design page | planes/execution/delivery-engine/services/environment-promotion-service/index.md |
PackagePublisherService¶
Existing CI; duplicate of DevOps PackagePublishingService
| Bounded context | BC-24 Package & Release Delivery |
| Granularity | external / canonical · ref ext-azure-devops |
| Former catalog group | Template & Library (external) |
| Status | unmodelled |
| Design page | not written yet |
PackagePublishingService¶
Existing CI
| Bounded context | BC-24 Package & Release Delivery |
| Granularity | external / canonical · ref ext-azure-devops |
| Former catalog group | DevOps / GitOps (external) |
| Status | unmodelled |
| Design page | not written yet |
PipelineExecutionService¶
Change proposals (branches, pull requests, reviews) and pipeline runs with typed results mirrored from the system of record; provenance to runs (BC-23).
| Bounded context | BC-23 Source & Pipelines |
| Granularity | module of host · host DeliveryHost |
| Former catalog group | DevOps / GitOps (module) |
| Status | target |
| Modelled | 2 aggregates · 6 REST + 1 gRPC · 5 events · 2 workers · 4 tables |
| Design page | planes/execution/delivery-engine/services/pipeline-execution-service/index.md |
PullRequestService¶
Azure DevOps / GitHub are the system of record; the Factory keeps receipts via connectors (BC-17)
| Bounded context | BC-23 Source & Pipelines |
| Granularity | external / canonical · ref ext-azure-devops |
| Former catalog group | DevOps / GitOps (external) |
| Status | unmodelled |
| Design page | not written yet |
ReleaseService¶
Immutable product releases with components, digests, SBOM, attestations and publication evidence (BC-24).
| Bounded context | BC-24 Package & Release Delivery |
| Granularity | module of host · host DeliveryHost |
| Former catalog group | DevOps / GitOps (module) |
| Status | target |
| Modelled | 1 aggregates · 4 REST + 1 gRPC · 3 events · 2 workers · 2 tables |
| Design page | planes/execution/delivery-engine/services/release-service/index.md |
RepositoryService¶
Azure DevOps / GitHub are the system of record; the Factory keeps receipts via connectors (BC-17)
| Bounded context | BC-23 Source & Pipelines |
| Granularity | external / canonical · ref ext-azure-devops |
| Former catalog group | DevOps / GitOps (external) |
| Status | unmodelled |
| Design page | not written yet |
TemplatePublishingService¶
Existing Azure Pipelines / Artifacts publishing
| Bounded context | BC-24 Package & Release Delivery |
| Granularity | external / canonical · ref ext-azure-devops |
| Former catalog group | Template & Library (external) |
| Status | unmodelled |
| Design page | not written yet |