aodb-api-helm

CI Release

Helm chart for aodb-api, a self-hosted replacement for the cidb.bebot.link item-search API that BeBot’s !items command relies on.

Deploys a single-instance FastAPI Deployment + Service. No database, no Ingress: the item dump is downloaded fresh into memory from a public HTTPS URL (aodbApi.dumpUrl) on every pod start, and the Service is meant to sit behind an externally-managed Cloudflare Tunnel (or similar) rather than a chart-owned Ingress.

Values

Key Type Default Description
aodbApi.dumpUrl string "" Public HTTPS URL to the item dump zip (a zipped <item aoid="..." .../> XML file). Downloaded fresh into memory on every pod start - no database, no credentials.
aodbApi.extraObjects list [] Raw Kubernetes objects to render alongside chart-managed resources.
aodbApi.imagePullSecrets list [] List of image pull secret names to attach to the ServiceAccount. Leave empty if the registry is public.
aodbApi.imageRepository string "ghcr.io/zznathans/aodb-api" Container image registry and repository for the aodb-api image.
aodbApi.imageTag string "1.3.0" Image tag to deploy.
aodbApi.replicaCount int 1 Number of pod replicas. Safe to run more than one - each replica independently loads its own in-memory copy of the dump from dumpUrl on startup, no shared state between them.
aodbApi.resources object {"limits":{"cpu":"250m","memory":"256Mi"},"requests":{"cpu":"50m","memory":"128Mi"}} Resource requests and limits for the app container.
aodbApi.service.port int 80 Port the Service listens on and forwards to the container’s 8000.

Development

helm lint charts/aodb-api --strict --set aodbApi.dumpUrl=https://example.invalid/dump.xml.zip
helm unittest charts/aodb-api

Published via chart-releaser to this repo’s gh-pages branch on every GitHub Release.