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 2026-03-12
2. Feature Flags 🔄 Replaced 2022-10-12 2026-03-12
3. Interacting with Internal Services ✔️ Implemented 2022-10-21 2026-03-12
4. Out-of-the-box image repository for StoneSoup users ✔️ Implemented 2023-07-14 2026-03-12
6. Log Conventions ✔️ Implemented 2022-11-11 2026-03-12
7. Change Management Process ✅ Accepted 2022-11-11 2026-03-12
8. Environment Provisioning 🔄 Replaced 2022-12-14 2026-03-12
9. Pipeline Service via Operator ✔️ Implemented 2023-10-04 2026-03-12
10. Namespace Metadata ✅ Accepted 2022-12-09 2026-03-12
11. Roles and Permissions for Konflux ✅ Accepted 2023-01-10 2026-03-12
12. Namespace Name Format ✅ Accepted 2023-01-23 2026-03-12
13. Konflux Test Stream - API contracts Deprecated 2022-11-29 2026-03-12
14. Let Pipelines Proceed ✅ Accepted 2023-01-31 2026-03-12
15. The Two-phase Architecture of the Integration Service Superseded 2023-02-09 2026-03-12
16. Promotion logic in the Integration Service Superseded 2023-02-14 2026-03-12
17. Use our own pipelines ✅ Accepted 2023-02-10 2026-03-12
18. Continuous Performance Testing (CPT) of Apps in Konflux In 2023-03-10 2026-03-12
19. Customize URLs Sent to GitHub ✅ Accepted 2023-03-29 2026-03-12
20. Source Retention ✅ Accepted 2023-04-05 2026-03-12
21. Partner Tasks in Build/Test Pipelines 🔄 Replaced 2023-04-03 2026-03-12
22. Secret Management For User Workloads ✅ Accepted 2022-12-03 2026-03-12
23. Git references to furnish Integration Test Scenarios Approved 2023-04-14 2026-03-12
24. Release Objects Attribution Tracking and Propagation ✅ Accepted 2023-04-26 2026-03-12
25. appstudio-pipeline Service Account ✅ Accepted 2023-05-30 2026-03-12
26. Specifying OCP targets for File-based Catalogs ✅ Accepted 2023-06-08 2026-03-12
27. Container Image Management Practice 📝 Proposed 2023-05-26 2026-03-12
28. Handling SnapshotEnvironmentBinding Errors Superceded 2023-08-29 2026-03-12
29. Component Dependencies ✅ Accepted 2023-06-27 2026-03-12
30. Tekton Results Naming Convention ✅ Accepted 2023-05-19 2026-03-12
31. Sprayproxy 🔄 Replaced 2023-10-25 2026-03-12
32. Decoupling Deployment ✅ Accepted 2023-11-05 2026-03-12
33. Enable Native OpenTelemetry Tracing ✅ Accepted 2024-02-27 2026-03-12
34. Project Controller for Multi-version support ✔️ Implemented 2024-05-09 2026-03-12
35. Continuous Chaos Testing of Apps in AppStudio ✅ Accepted 2024-03-05 2026-03-12
36. Trusted Artifacts ✔️ Implemented 2024-07-15 2026-03-12
37. Integration service promotes components to GCL immediately after builds complete ✅ Accepted 2024-06-21 2026-03-12
38. Integration service removes composite snapshots and logic around them ✅ Accepted 2024-07-09 2026-03-12
39. Workspace Deprecation ✔️ Implemented 2025-08-27 2026-03-12
40. Availability Probe Framework ✅ Accepted 2023-08-10 2026-03-12
41. Konflux should send cloud events all system events. ✅ Accepted 2024-09-24 2026-03-12
42. Provisioning Clusters for Integration Tests ✅ Accepted 2024-06-05 2026-03-12
44. SPDX SBOM support ✔️ Implemented 2024-10-24 2026-03-12
46. Build a common Task Runner image 🚧 Implementable 2024-11-22 2026-03-12
47. Caching for container base images used during builds 🚧 Implementable 2025-09-12 2026-03-12
48. Attestable Build-Time Tests in Integration Service ✅ Accepted 2025-10-08 2026-03-12
49. Verification Summary Attestations for Release Policies ✅ Accepted 2025-10-08 2026-03-12
50. Exclude Kubernetes Events API from User RBAC Roles ✔️ Implemented 2025-10-02 2026-03-12
51. KITE Architecture and Components 🚧 Implementable 2025-10-08 2026-03-12
52. GitOps Onboarding Redesign ✅ Accepted 2025-10-08 2026-03-12
53. Trusted Tasks model after build-definitions decentralization ✅ Accepted 2025-10-22 2026-03-12
54. Start versioning Tekton Tasks responsibly ✅ Accepted 2025-10-22 2026-03-12
55. SLSA Source Provenance Verification ✅ Accepted 2025-10-31 2026-03-12
56. Revised Component Model 🚧 Implementable 2025-11-21 2026-03-12
57. Pipeline Caching Feature Flag Configuration 🚧 Implementable 2025-12-02 2026-03-12
58. MintMaker log persistence 🚧 Implementable 2026-02-03 2026-03-12
59. Backend Usage Telemetry Collection from Konflux Clusters 🚧 Implementable 2026-02-24 2026-03-12
60. ComponentGroups 📝 Proposed 2026-02-27 2026-03-12
61. VCS Info Specification for Container Images 🚧 Implementable 2026-03-10 2026-03-12
62. Distributed Tracing 🚧 Implementable 2026-03-10 2026-03-13
63. Generalized Build and Release Pipelines 🚧 Implementable 2026-03-17 2026-03-17