feat(examples): simplify k8s Helm chart to MVP#234
Merged
MaojiaSheng merged 3 commits intomainfrom Feb 21, 2026
Merged
Conversation
Add a production-ready Helm chart for deploying OpenViking on Kubernetes
with support for GCP and AWS cloud providers.
Features:
- LoadBalancer service with cloud-specific annotations
- Support for GCP and AWS via values.yaml cloudProvider setting
- Secret management for ov.conf configuration
- Health checks (liveness and readiness probes)
- Optional HPA for autoscaling
- Optional PVC for persistent storage
- Uses uv container for streamlined deployment
- Comprehensive documentation
Usage:
helm install openviking ./deploy/helm/openviking \
--set cloudProvider=gcp \
--set openviking.config.embedding.dense.api_key=YOUR_KEY
Remove production-only complexity to make the chart easy to try locally: - Drop HPA, PVC, and ServiceAccount templates - Remove security contexts, cloud provider annotations, node affinity - Fix config: only embedding/vlm are valid confmap fields (no server/storage blocks) - Pass --host/--port as CLI args to openviking serve - Switch service default to ClusterIP with port-forward instructions - Use emptyDir for data volume - Simplify _helpers.tpl and values.yaml Tested against EKS: ov health and ov status both pass.
MaojiaSheng
approved these changes
Feb 21, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
embeddingandvlmare valid confmap fields;server/storageblocks caused a pydantic validation error at startup--host/--portas CLI args toopenviking serveinstead of embedding them in the config fileClusterIP(usekubectl port-forwardfor local access)emptyDirfor data — no PVC needed for a quick trialTest plan
helm lintpasses (0 failures)helm templaterenders all 3 resources cleanlyhelm install1/1 Running(packages cached on second run)curl /healthreturns{"status":"ok"}ov healthreturnshealthy truevia port-forwardov statusshows healthy queue + vikingdb componentsov ls viking://userlists directories correctly