Skip to content

WorkflowRun schema

The canonical schema for the WorkflowRun CRD. Source of truth: plnt/operators/crds/workflowrun.yaml.

Which runtime chart to deploy.

ValueChart
vllmplnt/charts/vllm-runtime
tgiplnt/charts/tgi-runtime
trt-llmplnt/charts/trt-llm-runtime
sglangplnt/charts/sglang-runtime
FieldTypeRequiredNotes
namestringCanonical model name (e.g. meta-llama/Llama-3.1-70B-Instruct).
storageUristringWhere weights live: s3://, gs://, oci://, hf://.
quantizationstringfp16 | fp8 | awq-4bit | gptq-4bit. Default fp16.
FieldTypeRequiredNotes
gpuinteger ≥ 1GPU count per replica.
gpuClassstringKubernetes GPU resource class (nvidia.com/h100, nvidia.com/a100, nvidia.com/a10).
memoryGiBinteger ≥ 1Container memory request.
FieldTypeDefaultNotes
mininteger ≥ 01HPA lower bound.
maxinteger ≥ 13HPA upper bound.
FieldTypeNotes
targetTokensPerSecondinteger ≥ 1Custom-metric HPA target. Requires prometheus-adapter mapped to plnt_tokens_per_sec_per_gpu.
FieldTypeDefaultNotes
trafficPercentinteger 1..1005Envoy VirtualService weight for the canary release.
smokeTest.promptsinteger ≥ 110How many test prompts to send.
smokeTest.ttftBudgetMsinteger ≥ 1Max TTFT p50 for the canary to pass.
smokeTest.tpotBudgetMsinteger ≥ 1Max TPOT p50 for the canary to pass.
FieldTypeValues
phasestringPending | Validating | PullingWeights | Deploying | SmokeTesting | Promoting | Ready | RolledBack | Failed
endpointstringIn-cluster URL once Ready.
workflowRunIdstringTemporal workflow run id.
lastErrorstringMessage from the most recent failed activity.
observedGenerationintegerMatches metadata.generation when reconciled.

kubectl get workflowrun shows:

NAME RUNTIME GPU PHASE ENDPOINT AGE
llama-3.1-70b-instruct vllm nvidia.com/h100 Ready ... 3h
Terminal window
kubectl apply -f plnt/operators/crds/workflowrun.yaml
kubectl apply -f examples/llama-3.1-70b-instruct.yaml