MATIH Platform is in active MVP development. Documentation reflects current implementation status.
17. Kubernetes & Helm
Control Plane Charts
Overview

Control Plane Charts Overview

The control plane consists of 10 Java Spring Boot services deployed via the matih-control-plane umbrella chart. Each service handles a specific platform management concern and follows the standard chart pattern with deployment, service, ingress, HPA, PDB, and ServiceMonitor templates.


Service Summary

ServicePortMin ReplicasHPA MaxKey Feature
iam-service8080210JWT auth, RBAC, user management
tenant-service808028Tenant lifecycle, provisioning
config-service808025Feature flags, hot reload
audit-service8080315Audit trail, SIEM forwarding
notification-service808028Multi-channel notifications
billing-service808026Usage tracking, cost allocation
api-gateway8080210API routing, rate limiting
observability-api808025Metrics aggregation
platform-registry808024Service registry
infrastructure-service808024Cloud infrastructure provisioning

Shared Configuration

All control plane services share:

  • PostgreSQL: Bitnami subchart with primary + 2 read replicas
  • Redis: Bitnami subchart with Sentinel HA
  • Kafka: Strimzi cluster in data plane (via FQDN)
  • Ingress: Kong API gateway with path-based routing

Ingress Routing

Control plane services are exposed through Kong ingress:

ingress:
  className: kong
  annotations:
    konghq.com/strip-path: "false"
    konghq.com/protocols: "https"
  hosts:
    - host: api.matih.ai
      paths:
        - path: /api/v1/auth      # -> iam-service
        - path: /api/v1/tenants   # -> tenant-service
        - path: /api/v1/config    # -> config-service
        - path: /api/v1/audit     # -> audit-service

Section Contents

Each page below details the Helm chart configuration for the respective service, including values snippets, deployment specs, and operational notes.