Kubeflow:Architecture
lastmod 2026-03-01created 2025-12-2925 edits
This guide introduces the Kubeflow projects and how they are used in each stage of the AI lifecycle.
Kubeflow Ecosystem
The following diagram gives an overview of the Kubeflow ecosystem and shows how it relates to the wider Kubernetes and AI landscape. Kubeflow is built on Kubernetes as a system for deploying, scaling, and managing AI platforms.
| |
Introducing the AI Lifecycle
When developing and deploying artificial intelligence (AI) applications, the AI lifecycle typically consists of several stages. Developing an AI system is an iterative process. You need to evaluate the outputs produced at the various stages of the AI lifecycle and modify the model and parameters as needed so that the model keeps producing the required results.
The following diagram shows the stages of the AI lifecycle in order.
| |
Let's look at each stage in more detail.
- Data Preparation stage - collect raw data, perform feature engineering to extract machine learning features to store in an offline feature store, and prepare training data for model development.
- If a single GPU cannot handle the model size, you need to use distributed training.
- The output of model training is a trained model artifact, which can be stored in the model registry.
- During model optimization, machine learning metadata can be stored in the model registry.
- Depending on the use case, the model can perform predictive or generative AI tasks.
- In the model serving stage, features can be extracted using an online feature store.
- Model performance is monitored and the results are fed back into earlier stages of the AI lifecycle.
AI Lifecycle for Production and Development Phases
The AI lifecycle of AI applications can conceptually be divided into a development phase and a production phase, and this diagram shows which tasks each phase includes.
| |
Kubeflow Projects in the AI Lifecycle
The following diagram shows how the Kubeflow projects fit into each stage of the AI lifecycle.
| |
See the following links for details on each Kubeflow project.
- Kubeflow Spark Operator can be used for the data preparation and feature engineering stages.
- Kubeflow Notebooks can be used for model development and interactive data science to experiment with AI workflows.
- Kubeflow Trainer can be used for large-scale distributed training or LLM (Learning Leadership Model) fine-tuning.
- Kubeflow Katib can be used for model optimization and hyperparameter tuning with various AutoML algorithms.
- Kubeflow Model Registry can be used to store machine learning metadata and model artifacts and to prepare models for deployment to production environments.
- KServe can be used for both online and batch inference in the model serving stage.
- Feast can be used as a feature store and can manage offline and online features.
- Kubeflow Pipelines can be used to build, deploy, and manage each stage of the AI lifecycle.
AI platform teams can build on Kubeflow to meet their specific requirements by using each project independently or by deploying the full AI reference platform
Kubeflow APIs and SDKs
Various Kubeflow projects provide APIs and Python SDKs.
See the following reference documentation.
- Reference documentation for the Kubeflow Pipelines API and SDK, which also includes the Kubeflow Pipelines domain-specific language (DSL).
What if we turn it into a gRPC API?
Cluster control:
- kubernetes REST API -> gRPC Interface Wrapping
S3 compatibility layer:
Mesh network:
Authentication/user management/security:
- Cert Manager <- domain registration (?)
- Dex
- OAuth2-Proxy <- needs to integrate with the security system already in use.
- Profiles + KFAM
Filesystem/Data Access:
- PVC Viewer Controller
- Volumes Web Application - Filesystem access control using Filebrowser.
- Spark Operator
MLOps Pipeline:
- Data preprocessing
- Labeling
- Jupyter Web Application
- Notebook Controller
- Tensorboards Web Application
- Tensorboard Controller
- Built-in feature of kubeflow itself
Other:
-
Central Dashboard - PodDefaults Webhook
Timeline
- January 2026
- Cluster control
- Kubernetes REST API -> gRPC Interface Wrapping
- Network Interface API -> exposing endpoints using Traefik/Envoy
- Filesystem/Data Access API
- Kubeflow PVC Viewer Controller API
- Filesystem API / CRUD
- Apply SeaweedFS as the S3 compatibility layer
- Kubeflow Spark Operator