Helm Chart Architecture Overview
MATIH uses 74 Helm charts organized into a layered architecture: a shared base library chart, individual service charts, and umbrella charts that compose services into deployable units. This section covers the chart structure, shared templates, values management, and chart development workflow.
Chart Hierarchy
infrastructure/helm/
|
+-- base/ # Library chart (matih-base v1.1.0)
| +-- templates/ # Shared template helpers
| +-- values.yaml # Default values documentation
|
+-- matih-control-plane/ # Umbrella chart - control plane
| +-- Chart.yaml # Dependencies: iam, tenant, config, etc.
| +-- templates/ # Shared resources (network policy, PDB)
|
+-- matih-data-plane/ # Umbrella chart - data plane
| +-- Chart.yaml # Dependencies: ai, query, catalog, etc.
| +-- templates/ # Shared resources (quotas, network)
|
+-- ai-service/ # Individual service chart
+-- query-engine/ # Individual service chart
+-- trino/ # Infrastructure chart
+-- ... # 70+ more chartsChart Categories
| Category | Count | Examples |
|---|---|---|
| Base library | 1 | matih-base |
| Umbrella charts | 4 | matih-control-plane, matih-data-plane, matih-monitoring-*, matih-observability |
| Control plane services | 10 | iam-service, tenant-service, config-service |
| Data plane services | 11 | ai-service, query-engine, bi-service |
| Data infrastructure | 12 | trino, kafka (Strimzi), postgresql, redis |
| ML infrastructure | 6 | mlflow, feast, ray, vllm, triton, jupyterhub |
| Frontend | 6 | bi-workbench, ml-workbench, data-workbench |
| Platform utilities | 10+ | external-secrets, cert-manager-config, ingress-nginx |
Section Contents
| Page | Description |
|---|---|
| Chart Structure | Standard chart directory layout and file conventions |
| Base Library | matih-base library chart with shared templates |
| Umbrella Charts | Control plane and data plane umbrella charts |
| Values Management | Values files, deep merge, and environment overlays |
| Chart Development | Creating new charts, testing, and linting |