models-as-a-service: Dataflow¶

Controller Watches¶

Kubernetes resources this controller monitors for changes. Each watch triggers reconciliation when the watched resource is created, updated, or deleted.

Type	GVK	Source
For	apps/v1/Deployment	`maas-controller/pkg/controller/maas/self_deployment_controller.go:292`
For	maas/v1alpha1/ExternalModel	`maas-controller/pkg/reconciler/externalmodel/reconciler.go:289`
For	maas/v1alpha1/MaaSAuthPolicy	`maas-controller/pkg/controller/maas/maasauthpolicy_controller.go:1232`
For	maas/v1alpha1/MaaSModelRef	`maas-controller/pkg/controller/maas/maasmodelref_controller.go:392`
For	maas/v1alpha1/MaaSSubscription	`maas-controller/pkg/controller/maas/maassubscription_controller.go:983`
For	maas/v1alpha1/Tenant	`maas-controller/pkg/controller/maas/tenant_controller.go:199`
Watches	apis/v1/HTTPRoute	`maas-controller/pkg/controller/maas/maassubscription_controller.go:996`
Watches	apis/v1/HTTPRoute	`maas-controller/pkg/controller/maas/maasmodelref_controller.go:398`
Watches	apis/v1/HTTPRoute	`maas-controller/pkg/controller/maas/maasauthpolicy_controller.go:1238`
Watches	maas/v1alpha1/MaaSAuthPolicy	`maas-controller/pkg/controller/maas/maasmodelref_controller.go:414`
Watches	maas/v1alpha1/MaaSModelRef	`maas-controller/pkg/controller/maas/maassubscription_controller.go:1000`
Watches	maas/v1alpha1/MaaSModelRef	`maas-controller/pkg/controller/maas/maasauthpolicy_controller.go:1242`
Watches	maas/v1alpha1/MaaSSubscription	`maas-controller/pkg/controller/maas/maasmodelref_controller.go:410`
Watches	serving/v1alpha1/LLMInferenceService	`maas-controller/pkg/controller/maas/maasmodelref_controller.go:403`

Reconciliation Flow¶

How the controller interacts with the Kubernetes API during reconciliation.

sequenceDiagram
    %% Static dataflow for models-as-a-service

    participant KubernetesAPI as Kubernetes API
    participant maas_api as maas-api
    participant maas_controller as maas-controller
    participant payload_processing as payload-processing

    KubernetesAPI->>+maas_api: Watch Deployment (reconcile)
    KubernetesAPI->>+maas_api: Watch ExternalModel (reconcile)
    KubernetesAPI->>+maas_api: Watch MaaSAuthPolicy (reconcile)
    KubernetesAPI->>+maas_api: Watch MaaSModelRef (reconcile)
    KubernetesAPI->>+maas_api: Watch MaaSSubscription (reconcile)
    KubernetesAPI->>+maas_api: Watch Tenant (reconcile)
    KubernetesAPI-->>+maas_api: Watch HTTPRoute (informer)
    KubernetesAPI-->>+maas_api: Watch HTTPRoute (informer)
    KubernetesAPI-->>+maas_api: Watch HTTPRoute (informer)
    KubernetesAPI-->>+maas_api: Watch MaaSAuthPolicy (informer)
    KubernetesAPI-->>+maas_api: Watch MaaSModelRef (informer)
    KubernetesAPI-->>+maas_api: Watch MaaSModelRef (informer)
    KubernetesAPI-->>+maas_api: Watch MaaSSubscription (informer)
    KubernetesAPI-->>+maas_api: Watch LLMInferenceService (informer)

    Note over maas_api: Exposed Services
    Note right of maas_api: maas-api:8080/TCP [http]
    Note right of maas_api: maas-api:9090/TCP [metrics]
    Note right of maas_api: maas-api:0/TCP []
    Note right of maas_api: maas-api:8443/TCP [https]
    Note right of maas_api: payload-processing:9004/TCP []

HTTP Endpoints¶

Method	Path	Source
OPTIONS	/*path	`maas-api/cmd/main.go:112`
DELETE	/:id	`maas-api/cmd/main.go:221`
GET	/:id	`maas-api/cmd/main.go:220`
*	/api-keys	`maas-api/cmd/main.go:216`
POST	/api-keys/cleanup	`maas-api/cmd/main.go:226`
POST	/api-keys/validate	`maas-api/cmd/main.go:225`
POST	/bulk-revoke	`maas-api/cmd/main.go:219`
GET	/health	`maas-api/cmd/main.go:179`
*	/internal/v1	`maas-api/cmd/main.go:224`
*	/metrics	`maas-api/internal/metrics/server.go:19`
GET	/model/:model-id/subscriptions	`maas-api/cmd/main.go:213`
GET	/models	`maas-api/cmd/main.go:209`
POST	/search	`maas-api/cmd/main.go:218`
GET	/subscriptions	`maas-api/cmd/main.go:212`
POST	/subscriptions/select	`maas-api/cmd/main.go:227`
*	/v1	`maas-api/cmd/main.go:185`

Configuration¶

ConfigMaps and Helm values that control this component's runtime behavior.