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 🔄 Replaced 2023-04-03 2025-10-22
22. Secret Management For User Workloads ✅ Accepted 2022-12-03 2025-09-16
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
34. Project Controller for Multi-version support ✔️ Implemented 2024-05-09 2025-10-08
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 ✔️ Implemented 2024-07-15 2025-10-08
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
41. Konflux should send cloud events all system events. ✅ Accepted 2024-09-24 2025-10-08
44. SPDX SBOM support ✔️ Implemented 2024-10-24 2025-10-08
46. Build a common Task Runner image 🚧 Implementable 2024-11-22 2025-10-08
47. Caching for container base images used during builds 🚧 Implementable 2025-09-12 2025-10-26
48. Attestable Build-Time Tests in Integration Service ✅ Accepted 2025-10-08 2025-10-08
49. Verification Summary Attestations for Release Policies ✅ Accepted 2025-10-08 2025-10-08
50. Exclude Kubernetes Events API from User RBAC Roles ✔️ Implemented 2025-10-02 2025-10-02
51. KITE Architecture and Components 🚧 Implementable 2025-10-08 2025-10-08
52. GitOps Onboarding Redesign ✅ Accepted 2025-10-08 2025-10-13
53. Trusted Tasks model after build-definitions decentralization ✅ Accepted 2025-10-22 2025-10-27
54. Start versioning Tekton Tasks responsibly ✅ Accepted 2025-10-22 2025-10-27
55. SLSA Source Provenance Verification ✅ Accepted 2025-10-31 2025-10-31