Documentation Index
Fetch the complete documentation index at: https://docs.getbifrost.ai/llms.txt
Use this file to discover all available pages before exploring further.
Changelog
- Includes unreleased
2.1.5changes - Built-in plugin versioning for DB-backed deployments:
- Added
versionfield support for built-in plugins. - Added default
version: 1for built-in plugins invalues.yaml(telemetry,logging,governance,maxim,semanticCache,otel,datadog). - Updated
_helpers.tplto include pluginversionin rendered config when set (cast as integer).
- Added
- Updated StatefulSet PVC template labels to be immutable-safe:
spec.volumeClaimTemplates.metadata.labelsnow uses stable selector labels (without chart/app version labels).
- Governance schema and validation updates:
- Added
governance.budgets[].virtual_key_idsupport. - Removed stale
budget_idreferences from virtual keys and provider configs in templates/tests. validate-helm-config-fields.shassertions were updated accordingly.
- Added
- Query/schema compatibility updates:
- Tightened
queryvalidation invalues.schema.jsonandconfig.schema.jsonto valid RuleGroupType shape (nullor{ combinator, rules }).
- Tightened
- Config/input alias support updates:
- Added support for
env.*references in proxy/TLS fields (ca_cert_pem,url,username,password). - Added
provider_key_namealias for routing targets and pricing overrides (resolved tokey_idat config load time).
- Added support for
- MCP config improvements:
- Added Go duration string support for
mcp.toolSyncInterval(legacy numeric nanoseconds still supported). - Added hash-based MCP client config reconciliation for DB-backed config store updates.
- Added Go duration string support for
- Upgrade impact:
- Existing SQLite StatefulSets created from older chart templates may require a one-time StatefulSet recreation during upgrade because
spec.volumeClaimTemplatesis immutable in Kubernetes.
- Existing SQLite StatefulSets created from older chart templates may require a one-time StatefulSet recreation during upgrade because
- Migration notes (only if upgrade fails with StatefulSet immutable-field error):
- Identify StatefulSet name and namespace for your Helm release.
- Delete only the StatefulSet while preserving dependents:
kubectl delete statefulset <statefulset-name> -n <namespace> --cascade=orphan
- Run Helm upgrade:
helm upgrade <release-name> bifrost/bifrost -n <namespace> -f <values-file> --set image.tag=<tag>
- If needed, re-apply/recreate the StatefulSet from the upgraded chart manifests.
- Verify PVCs are preserved and pods become healthy:
kubectl get pvc -n <namespace>kubectl get pods -n <namespace>

