Chat API Helm Chart

Helm chart for deploying app-poly-gitops-fastapi to Kubernetes. The chart packages the Deployment, Service, optional Ingress, ServiceAccount, and optional external-service wiring.

Overview

• Chart version: 0.4.1
• Application version and default image tag: 1.1.2
• Default service: ClusterIP on port 80
• Default database: SQLite on the pod filesystem; the chart creates no persistent volume
• Optional dependencies: OpenRouter secret and PostgreSQL connection secret

No secret is required for rendering the chart or starting the health endpoint. Real model requests require a secret selected with openrouterSecretRefName. PostgreSQL can be supplied through postgresSecretRefName or explicit extraEnv entries. Use an external database when data must survive pod replacement.

serviceAccount.create=true creates and selects one ServiceAccount. Set serviceAccount.name to override its name. With serviceAccount.create=false, serviceAccount.name is required and must identify an existing account.

createInternalSecret=true creates a chart-managed Secret for the non-sensitive provider URL, model and optional attribution headers, and attaches it to the Deployment. It does not store a provider key. postgres.externalService.enabled only creates the stable postgres-external DNS name for an external host; it cannot construct credentials or a database name, so DATABASE_URL must still be provided through postgresSecretRefName or extraEnv.

Getting started

Requirements: Helm 3 and access to a Kubernetes cluster for installation.

helm lint .
helm template chat-api . --namespace chat-api

To install the defaults:

helm upgrade --install chat-api . \
  --namespace chat-api \
  --create-namespace

For a real provider key, create the Secret outside the chart and reference it:

kubectl create namespace chat-api --dry-run=client -o yaml | kubectl apply -f -

IFS= read -r -s -p "OpenRouter API key: " OPENROUTER_API_KEY
printf '\n'
printf %s "$OPENROUTER_API_KEY" |
  kubectl -n chat-api create secret generic chat-openrouter \
    --from-file=OPENROUTER_API_KEY=/dev/stdin
unset OPENROUTER_API_KEY

helm upgrade --install chat-api . \
  --namespace chat-api \
  --set openrouterSecretRefName=chat-openrouter

Configuration

Value	Default	Purpose
image.repository	ghcr.io/justgithubaccount/app-poly-gitops-fastapi	Runtime image
image.tag	1.1.2	Runtime image tag
replicaCount	1	Deployment replicas
service.port	80	Service port
openrouter.apiUrl	OpenRouter chat-completions endpoint	Provider endpoint
openrouter.defaultModel	anthropic/claude-opus-4	Model identifier
openrouterSecretRefName	empty	Existing provider Secret
postgresSecretRefName	empty	Existing database Secret
serviceAccount.create	true	Create a ServiceAccount
serviceAccount.name	empty	Created-account override, or required existing account name
createInternalSecret	false	Create and consume non-sensitive provider configuration
postgres.externalService.enabled	false	Create an ExternalName Service; does not set DATABASE_URL
ingress.enabled	false	Render an Ingress
extraEnv	[]	Additional container environment entries

See values.yaml for resource requests, probes, telemetry settings, Ingress options, and the complete value set.

Repository structure

• Chart.yaml — chart metadata
• values.yaml — default values
• templates/ — Kubernetes templates
• tests/test_chart.sh — lint and rendered-contract checks
• tests/test_downstream.sh — current GitOps values and chart-pin compatibility

Run the repository check with:

bash tests/test_chart.sh
bash tests/test_downstream.sh ../app-poly-gitops-k8s

Related repositories

• app-poly-gitops-fastapi — packaged application
• app-poly-gitops-k8s — environment-specific GitOps values
• app-poly-gitops-infra — cluster provisioning and Argo CD bootstrap
• app-mono-gitops — archived predecessor

License

MIT