<#7249 Add system architecture documentation> Pull...
# flyte-github
a
#7249 Add system architecture documentation Pull request opened by pingsutw on <!date^1776804314^{date_short}|2026-04-21T20:45:14Z> Tracking issue N/A Why are the changes needed? The Flyte 2 backend currently lacks a centralized architecture document. This makes it harder for new contributors and users to understand how the system components fit together, how data flows through the platform, and what role each service plays. What changes were proposed in this pull request? Add
docs/architecture.md
covering: • High-level overview with ASCII architecture diagrams (control plane + data plane) • End-to-end data flow from
CreateRun
through pod execution to streaming results • Component reference for all services (Runs, Executor, Actions, DataProxy, Cache, Events, Secret, App, Copilot, Manager) • Shared libraries (flytestdlib, flyteplugins, flyteidl2) • Plugin system architecture with lifecycle and built-in plugin catalog • Infrastructure dependencies (Kubernetes, PostgreSQL, Object Storage) • Full API surface — user-facing and internal gRPC services • Deployment modes — unified, split, multi-cluster • Security layers • Key source locations quick-reference table How was this patch tested? Documentation only — no code changes. Check all the applicable boxes • I updated the documentation accordingly. • All new and existing tests passed. • All commits are signed-off. •
main
• #6583 • Add system architecture documentation 👈 flyteorg/flyte