Recipe
vllm-kubeai
vLLM realized as a KubeAI Model the KubeAI operator reconciles, rather than a directly synthesized StatefulSet — a second controller-driven realization of the same model component, selectable in the Manifest alongside the synthesis recipe and the KServe realization. The recipe emits a Model custom resource whose url is the model pointer; the operator serves it behind its OpenAI-compatible proxy and autoscales it. The model value is a deterministic pointer the operator resolves at reconcile time; the compiler never fetches weights. GPU and CPU sizing carry through resourceProfile. provides is filled from the operator's proxy, which addresses a model by its resource name, so a consumer wires to it exactly as it would to the synthesized realization. An attached api_key reaches the server through the Model's envFrom, which imports the credential's secret by name and names each variable after one of its data keys, so the credential publishes its key as VLLM_API_KEY, and the build halts naming the key when it does not. The KubeAI control plane is a runtime prerequisite: the build halts unless the operator affirms it is installed (infra.control_plane_present), so no custom resource is emitted into a cluster that cannot reconcile it. The Model is written into the namespace the Release, or else the Aggregate, names for this component through the aggrega.ai/namespace annotation, where one is set, and the operator creates the model's pods there; the metrics keys publish the pod label, port name and path a scraper discovers those pods by.
Provenance
- Content digest
- sha256:87547c9db1672236495dcfc92d462ffef874c08d1e106e33fb90e571e4af47dd
- Published
- 2026-11-10T10:28:00Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:7be843fe44c8081ec54eafe898757702098034be7c6955fdf1910671a01e3fde
Reference at this version
oci://hub.aggrega.ai/recipe/helm/vllm-kubeai:1.0.0- Target
- —
- Implements
- core/ai-model/vllm:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
| Name | Template |
|---|---|
| host | kubeai |
| port | 80 |
| endpoint | http://kubeai/openai/v1 |
| model | {{ .context.instance_id }} |
| protocol | http |
| metrics_endpoint | |
| metrics_service | |
| metrics_service_port | |
| metrics_pod_selector | kubeai.org/model={{ .context.instance_id }} |
| metrics_pod_port | http |
| metrics_path | /metrics |
Workload
No workload template declared.
Locals
No locals declared.
Values mapping
No values mapping declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- implementsimplementscontract compatible
core/ai-model/vllm:1.0.0
All required outputs are satisfied and every provided output is named in the contract.
Used by
Nothing in the catalog depends on this entity.