# konflux-ci/konflux-ci architecture

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

- Interactive diagram: https://gitdiagram.com/konflux-ci/konflux-ci
- Repository: https://github.com/konflux-ci/konflux-ci

## Overview

Konflux is a Kubernetes operator that configures and manages the components of a cloud-native software factory; it is not the build and release pipeline implementation itself. The user-facing workflow is to configure a Konflux instance through Kubernetes resources, after which the operator reconciles enabled services and reports their status. The graph includes the documented build, integration-test, release, and supply-chain-trust capabilities, plus operator-managed platform services. Controller-to-controller coordination is shown only where the excerpts support it; several subsystem details are unsampled.

Main entry points: [`operator/internal/controller/konflux/konflux_controller.go`](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/konflux/konflux_controller.go) (Instance Reconciler), [`operator/pkg/tracking/tracking.go`](https://github.com/konflux-ci/konflux-ci/blob/main/operator/pkg/tracking/tracking.go) (Resource Tracking), [`operator/internal/controller/buildservice/konfluxbuildservice_controller.go`](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/buildservice/konfluxbuildservice_controller.go) (Build Service), [`operator/internal/controller/integrationservice/konfluxintegrationservice_controller.go`](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/integrationservice/konfluxintegrationservice_controller.go) (Integration Tests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordination["Operator Coordination"]
  node_operator_entry["Operator Startup<br/>[main.go]"]
  node_konflux_api["Konflux Resources<br/>[konflux_types.go]"]
  node_konflux_reconciler["Instance Reconciler"]
end

subgraph group_delivery["Delivery Services"]
  node_build_service["Build Service"]
  node_integration_service["Integration Tests"]
  node_release_service["Release Service"]
  node_enterprise_contract["Policy Integration"]
  node_image_controller["Image Controller"]
  node_internal_registry["Internal Registry"]
end

subgraph group_platform["Platform Services"]
  node_cert_manager["Certificate Manager"]
  node_default_tenant["Tenant Setup"]
  node_namespace_lister["Namespace Lister"]
  node_ui_controller["Konflux UI"]
  node_info_controller["Cluster Info"]
  node_segment_bridge["Segment Bridge"]
end

subgraph group_shared["Shared Operator Layers"]
  node_tracking["Resource Tracking<br/>[tracking.go]"]
  node_manifests["Manifest Store<br/>[manifests.go]"]
end

node_cluster_admin(("Cluster Admin"))
node_tekton["Tekton"]
node_conforma["Conforma Policies"]

node_cluster_admin -->|"configures"| node_konflux_api
node_operator_entry -.->|"starts"| node_konflux_reconciler
node_konflux_reconciler -->|"reads status"| node_konflux_api
node_konflux_reconciler -->|"reads status"| node_build_service
node_konflux_reconciler -->|"reads status"| node_integration_service
node_konflux_reconciler -->|"reads status"| node_ui_controller
node_build_service -->|"tracks resources"| node_tracking
node_integration_service -->|"tracks resources"| node_tracking
node_release_service -->|"tracks resources"| node_tracking
node_image_controller -.->|"tracks resources"| node_tracking
node_segment_bridge -->|"tracks resources"| node_tracking
node_build_service -->|"loads manifests"| node_manifests
node_integration_service -->|"loads manifests"| node_manifests
node_release_service -->|"loads manifests"| node_manifests
node_tekton -.->|"pipeline integration"| node_build_service
node_conforma -.->|"policy integration"| node_enterprise_contract

click node_operator_entry "https://github.com/konflux-ci/konflux-ci/blob/main/operator/cmd/main.go"
click node_konflux_api "https://github.com/konflux-ci/konflux-ci/blob/main/operator/api/v1alpha1/konflux_types.go"
click node_konflux_reconciler "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/konflux/konflux_controller.go"
click node_build_service "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/buildservice/konfluxbuildservice_controller.go"
click node_integration_service "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/integrationservice/konfluxintegrationservice_controller.go"
click node_release_service "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/releaseservice/konfluxreleaseservice_controller.go"
click node_enterprise_contract "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/enterprisecontract/konfluxenterprisecontract_controller.go"
click node_image_controller "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/imagecontroller/konfluximagecontroller_controller.go"
click node_internal_registry "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/internalregistry/konfluxinternalregistry_controller.go"
click node_cert_manager "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/certmanager/konfluxcertmanager_controller.go"
click node_default_tenant "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/defaulttenant/konfluxdefaulttenant_controller.go"
click node_namespace_lister "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/namespacelister/konfluxnamespacelister_controller.go"
click node_ui_controller "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/ui/konfluxui_controller.go"
click node_info_controller "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/info/konfluxinfo_controller.go"
click node_segment_bridge "https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/segmentbridge/konfluxsegmentbridge_controller.go"
click node_tracking "https://github.com/konflux-ci/konflux-ci/blob/main/operator/pkg/tracking/tracking.go"
click node_manifests "https://github.com/konflux-ci/konflux-ci/blob/main/operator/pkg/manifests/manifests.go"

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_operator_entry,node_konflux_api,node_konflux_reconciler toneBlue
class node_build_service,node_integration_service,node_release_service,node_enterprise_contract,node_image_controller,node_internal_registry toneAmber
class node_cert_manager,node_default_tenant,node_namespace_lister,node_ui_controller,node_info_controller,node_segment_bridge toneMint
class node_tracking,node_manifests toneRose
class node_cluster_admin,node_tekton,node_conforma toneIndigo
```

## Components

### Operator Coordination

- [Operator Startup](https://github.com/konflux-ci/konflux-ci/blob/main/operator/cmd/main.go): `operator/cmd/main.go`
- [Konflux Resources](https://github.com/konflux-ci/konflux-ci/blob/main/operator/api/v1alpha1/konflux_types.go): `operator/api/v1alpha1/konflux_types.go`
- [Instance Reconciler](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/konflux/konflux_controller.go): `operator/internal/controller/konflux/konflux_controller.go`

### Delivery Services

- [Build Service](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/buildservice/konfluxbuildservice_controller.go): `operator/internal/controller/buildservice/konfluxbuildservice_controller.go`
- [Integration Tests](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/integrationservice/konfluxintegrationservice_controller.go): `operator/internal/controller/integrationservice/konfluxintegrationservice_controller.go`
- [Release Service](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/releaseservice/konfluxreleaseservice_controller.go): `operator/internal/controller/releaseservice/konfluxreleaseservice_controller.go`
- [Policy Integration](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/enterprisecontract/konfluxenterprisecontract_controller.go): `operator/internal/controller/enterprisecontract/konfluxenterprisecontract_controller.go`
- [Image Controller](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/imagecontroller/konfluximagecontroller_controller.go): `operator/internal/controller/imagecontroller/konfluximagecontroller_controller.go`
- [Internal Registry](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/internalregistry/konfluxinternalregistry_controller.go): `operator/internal/controller/internalregistry/konfluxinternalregistry_controller.go`

### Platform Services

- [Certificate Manager](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/certmanager/konfluxcertmanager_controller.go): `operator/internal/controller/certmanager/konfluxcertmanager_controller.go`
- [Tenant Setup](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/defaulttenant/konfluxdefaulttenant_controller.go): `operator/internal/controller/defaulttenant/konfluxdefaulttenant_controller.go`
- [Namespace Lister](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/namespacelister/konfluxnamespacelister_controller.go): `operator/internal/controller/namespacelister/konfluxnamespacelister_controller.go`
- [Konflux UI](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/ui/konfluxui_controller.go): `operator/internal/controller/ui/konfluxui_controller.go`
- [Cluster Info](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/info/konfluxinfo_controller.go): `operator/internal/controller/info/konfluxinfo_controller.go`
- [Segment Bridge](https://github.com/konflux-ci/konflux-ci/blob/main/operator/internal/controller/segmentbridge/konfluxsegmentbridge_controller.go): `operator/internal/controller/segmentbridge/konfluxsegmentbridge_controller.go`

### Shared Operator Layers

- [Resource Tracking](https://github.com/konflux-ci/konflux-ci/blob/main/operator/pkg/tracking/tracking.go): `operator/pkg/tracking/tracking.go`
- [Manifest Store](https://github.com/konflux-ci/konflux-ci/blob/main/operator/pkg/manifests/manifests.go): `operator/pkg/manifests/manifests.go`

### Other components

- **Cluster Admin**
- **Tekton**
- **Conforma Policies**

## Connections

- Cluster Admin → Konflux Resources: configures (evidence: `README.md`)
- Operator Startup → Instance Reconciler: starts
- Instance Reconciler → Konflux Resources: reads status (evidence: `operator/internal/controller/konflux/konflux_controller.go`)
- Instance Reconciler → Build Service: reads status (evidence: `operator/internal/controller/konflux/konflux_controller.go`)
- Instance Reconciler → Integration Tests: reads status (evidence: `operator/internal/controller/konflux/konflux_controller.go`)
- Instance Reconciler → Konflux UI: reads status (evidence: `operator/internal/controller/konflux/konflux_controller.go`)
- Build Service → Resource Tracking: tracks resources (evidence: `operator/internal/controller/buildservice/konfluxbuildservice_controller.go`)
- Integration Tests → Resource Tracking: tracks resources (evidence: `operator/internal/controller/integrationservice/konfluxintegrationservice_controller.go`)
- Release Service → Resource Tracking: tracks resources (evidence: `operator/internal/controller/releaseservice/konfluxreleaseservice_controller.go`)
- Image Controller → Resource Tracking: tracks resources
- Segment Bridge → Resource Tracking: tracks resources (evidence: `operator/internal/controller/segmentbridge/konfluxsegmentbridge_controller.go`)
- Build Service → Manifest Store: loads manifests (evidence: `operator/internal/controller/buildservice/konfluxbuildservice_controller.go`)
- Integration Tests → Manifest Store: loads manifests (evidence: `operator/internal/controller/integrationservice/konfluxintegrationservice_controller.go`)
- Release Service → Manifest Store: loads manifests (evidence: `operator/internal/controller/releaseservice/konfluxreleaseservice_controller.go`)
- Tekton → Build Service: pipeline integration (evidence: `README.md`)
- Conforma Policies → Policy Integration: policy integration (evidence: `README.md`)
