How ishitasequeira/models-as-a-service works
MaaS is an OpenShift/Kubernetes platform for publishing model access with tenant, subscription, authentication, and guardrail policy management. Its main control-plane workflow reconciles MaaS resources into tenant/platform configuration; the MaaS API then serves model discovery, subscriptions, and API-key operations to callers. A separate discovery service exposes visible tenants, while an optional usage-log proxy authenticates callers and queries Loki. The graph follows documented capabilities and indexed references; unsampled controller and API internals limit some call-level detail.
Main entry points: manager/main.go Controller manager · cmd/main.go HTTP API · pipeline.go Platform reconciliation · main.py Usage-log proxy
Components 25
Control plane
- Controller manager
maas-controller/cmd/manager/main.go - MaaS resources
maas-controller/api/maas/v1alpha1/maassubscription_types.go - Tenant reconciliation
maas-controller/pkg/controller/maas/tenant_controller.go - AI tenant lifecycle
maas-controller/pkg/controller/maas/aitenant_controller.go - Subscription policy
maas-controller/pkg/controller/maas/maassubscription_controller.go - Auth policy
maas-controller/pkg/controller/maas/maasauthpolicy_controller.go - Model references
maas-controller/pkg/controller/maas/maasmodelref_controller.go - Self deployment
maas-controller/pkg/controller/maas/self_deployment_controller.go - Platform reconciliation
maas-controller/pkg/platform/tenantreconcile/pipeline.go
MaaS API
- HTTP API
maas-api/cmd/main.go - API key operations
maas-api/internal/api_keys/handler.go - API key service
maas-api/internal/api_keys/service.go - Subscription endpoints
maas-api/internal/subscription/handler.go - Tenant endpoint
maas-api/internal/tenant/handler.go - Loki proxy handler
maas-api/internal/lokiproxy/handler.go
Tenant discovery
- Discovery service
maas-discovery/cmd/discovery/main.go - Tenant listing
maas-discovery/internal/handler/handler.go - Tenant informer cache
maas-discovery/internal/cache/informer.go - Gateway metadata
maas-discovery/internal/gateway/metadata.go
Usage logs
- Usage-log proxy
deployment/components/observability/usage-logs/dsci-managed/proxy/main.py - Token authentication
deployment/components/observability/usage-logs/dsci-managed/proxy/auth.py - Query rewriting
deployment/components/observability/usage-logs/dsci-managed/proxy/rewriter.py
Other components
- Cluster operator
- Loki service
- API caller
Connections 31
- Cluster operator → Controller manager: deploys
README.md - Controller manager → Tenant reconciliation: registers
maas-controller/cmd/manager/main.go - Controller manager → AI tenant lifecycle: registers
maas-controller/cmd/manager/main.go - Controller manager → Subscription policy: registers
maas-controller/cmd/manager/main.go - Controller manager → Auth policy: registers
maas-controller/cmd/manager/main.go - Controller manager → Model references: registers
maas-controller/cmd/manager/main.go - Controller manager → Self deployment: registers
maas-controller/cmd/manager/main.go - Tenant reconciliation → Platform reconciliation: uses
maas-controller/pkg/controller/maas/tenant_controller.go - AI tenant lifecycle → Platform reconciliation: uses
maas-controller/pkg/controller/maas/aitenant_controller.go - Subscription policy → Platform reconciliation: uses
maas-controller/pkg/controller/maas/maassubscription_controller.go - Auth policy → Platform reconciliation: uses
maas-controller/pkg/controller/maas/maasauthpolicy_controller.go - Self deployment → Platform reconciliation: uses
maas-controller/pkg/controller/maas/self_deployment_controller.go - Auth policy → MaaS resources: reads
maas-controller/pkg/controller/maas/maasauthpolicy_controller.go - Model references → MaaS resources: reads
maas-controller/pkg/controller/maas/maasmodelref_controller.go - Subscription policy → MaaS resources: reads
maas-controller/pkg/controller/maas/maassubscription_controller.go - Platform reconciliation → HTTP API: deploys
README.md - API caller → HTTP API: requests
maas-api/cmd/main.go - HTTP API → API key operations: routes
maas-api/cmd/main.go - HTTP API → Subscription endpoints: routes
maas-api/cmd/main.go - HTTP API → Tenant endpoint: routes
maas-api/cmd/main.go - API key operations → API key service: calls
maas-api/internal/api_keys/handler.go - HTTP API → Loki proxy handler: configures
maas-api/cmd/main.go - API caller → Discovery service: requests
maas-discovery/cmd/discovery/main.go - Discovery service → Tenant listing: registers routes
maas-discovery/cmd/discovery/main.go - Tenant listing → Tenant informer cache: lists tenants
maas-discovery/internal/handler/handler.go - Tenant informer cache → Gateway metadata: uses
maas-discovery/internal/cache/informer.go - API caller → Usage-log proxy: queries logs
deployment/components/observability/usage-logs/dsci-managed/proxy/main.py - Usage-log proxy → Token authentication: authenticates
deployment/components/observability/usage-logs/dsci-managed/proxy/main.py - Usage-log proxy → Query rewriting: rewrites queries
deployment/components/observability/usage-logs/dsci-managed/proxy/main.py - Usage-log proxy → Loki service: forwards queries
deployment/components/observability/usage-logs/dsci-managed/proxy/main.py - API caller → Loki proxy handler: requests logs