Architecture Of Konflux

Architecture Decision Records

An Architecture Decision Record (ADR) is a document that captures an important architectural decision made along with its context and consequences.

ADR Status Created Updated
1. Pipeline Service Phase 1 🔄 Replaced 2022-10-29 2025-09-24
2. Feature Flags 🔄 Replaced 2022-10-12 2025-09-12
3. Interacting with Internal Services ✔️ Implemented 2022-10-21 2025-10-02
4. Out-of-the-box image repository for StoneSoup users ✔️ Implemented 2023-07-14 2025-10-02
6. Log Conventions ✔️ Implemented 2022-11-11 2025-10-02
7. Change Management Process ✅ Accepted 2022-11-11 2023-04-05
8. Environment Provisioning 🔄 Replaced 2022-12-14 2025-10-02
9. Pipeline Service via Operator ✔️ Implemented 2023-10-04 2025-10-02
10. Namespace Metadata ✅ Accepted 2022-12-09 2024-04-23
11. Roles and Permissions for Konflux ✅ Accepted 2023-01-10 2025-10-02
12. Namespace Name Format ✅ Accepted 2023-01-23 2024-04-23
13. Konflux Test Stream - API contracts Deprecated 2022-11-29 2024-04-23
14. Let Pipelines Proceed ✅ Accepted 2023-01-31 2024-04-23
15. The Two-phase Architecture of the Integration Service Superseded 2023-02-09 2024-06-21
16. Promotion logic in the Integration Service Superseded 2023-02-14 2024-06-21
17. Use our own pipelines ✅ Accepted 2023-02-10 2024-04-23
18. Continuous Performance Testing (CPT) of Apps in Konflux In 2023-03-10 2024-04-23
19. Customize URLs Sent to GitHub ✅ Accepted 2023-03-29 2024-04-23
20. Source Retention ✅ Accepted 2023-04-05 2024-04-23
21. Partner Tasks in Build/Test Pipelines ✅ Accepted 2023-04-03 2023-12-01
22. Secret Management For User Workloads ✅ Accepted 2022-12-03 2024-01-26
23. Git references to furnish Integration Test Scenarios Approved 2023-04-14 2023-12-01
24. Release Objects Attribution Tracking and Propagation ✅ Accepted 2023-04-26 2023-11-21
25. appstudio-pipeline Service Account ✅ Accepted 2023-05-30 2024-04-23
26. Specifying OCP targets for File-based Catalogs ✅ Accepted 2023-06-08 2024-04-23
27. Availability Probe Framework ✅ Accepted 2023-08-10 2024-04-23
27. Container Image Management Practice 📝 Proposed 2023-05-26 2024-04-23
28. Handling SnapshotEnvironmentBinding Errors Superceded 2023-08-29 2023-11-30
29. Component Dependencies ✅ Accepted 2023-06-27 2024-04-23
30. Tekton Results Naming Convention ✅ Accepted 2023-05-19 2024-04-23
31. Sprayproxy ✅ Accepted 2023-10-25 2024-04-23
32. Decoupling Deployment ✅ Accepted 2023-11-05 2024-04-23
33. Enable Native OpenTelemetry Tracing ✅ Accepted 2024-02-27 2024-04-09
0034 Project Controller for Multi-version support Proposed. 2024-05-09 2024-05-09
35. Continuous Chaos Testing of Apps in AppStudio ✅ Accepted 2024-03-05 2024-03-05
35. Provisioning Clusters for Integration Tests ✅ Accepted 2024-06-05 2024-06-05
36. Trusted Artifacts ✅ Accepted 2024-07-15 2024-07-15
37. Integration service promotes components to GCL immediately after builds complete ✅ Accepted 2024-06-21 2024-07-09
38. Integration service removes composite snapshots and logic around them ✅ Accepted 2024-07-09 2024-07-09
39. Workspace Deprecation ✔️ Implemented 2025-08-27 2025-08-27
40. Konflux should send cloud events all system events. 📝 Proposed 2024-09-24 2024-09-24
44. SPDX SBOM support ✅ Accepted 2024-10-24 2024-11-26
46. Build a common Task Runner image ✅ Accepted 2024-11-22 2025-05-19
47. Caching for container base images used during builds 🚧 Implementable 2025-09-12 2025-09-14
50. Exclude Kubernetes Events API from User RBAC Roles ✔️ Implemented 2025-10-02 2025-10-02