helm-charts

This repository stores Helm charts for applications and supporting services. It is meant to host multiple charts over time.

Repository structure

• charts/fastapi-app: Helm chart for the birthday API application

Each chart should contain:

• its own Chart.yaml
• its own values.yaml
• its own templates
• its own chart-specific README with install, test, and maintenance instructions

Working in this repository

List chart files

find charts -maxdepth 3 -type f | sort

Fetch dependencies for a chart

helm dependency update charts/fastapi-app

Lint a chart

helm lint charts/fastapi-app

Render a chart without installing it

helm template fastapi-app charts/fastapi-app

fastapi-app chart

The first chart in this repo is:

• charts/fastapi-app

Chart-specific usage, credentials, testing, upgrade, cleanup, and versioning instructions are documented in:

• charts/fastapi-app/README.md

How to maintain this repo

When you add a new chart:

1. create a new folder under charts/
2. add a chart-specific README inside that chart folder
3. document dependencies and secrets explicitly
4. verify with:

helm dependency update charts/<chart-name>
helm lint charts/<chart-name>
helm template <release-name> charts/<chart-name>

Local test cycle

A typical local test cycle is:

minikube start
kubectl create namespace <namespace>
helm dependency update charts/<chart-name>
helm install <release-name> charts/<chart-name> -n <namespace>
kubectl get pods -n <namespace>
kubectl port-forward -n <namespace> svc/<service-name> 8000:8000

After testing:

helm uninstall <release-name> -n <namespace>
kubectl delete namespace <namespace>

If the chart needs secrets, see that chart's own README for the exact secret format.