kubernetes_project_template
A small project that supports both Docker Compose and Kubernetes.
Stack
- backend: FastAPI
- frontend: Nginx serving static files and proxying
/apitobackend - local development and Kubernetes
Prerequisites
For local use:
- Docker
- Docker
- kind
- kubectl
Run with Docker Compose
Normal run:
docker compose -f docker-compose.yaml up --build
Test-style override run:
docker compose -f docker-compose.yaml -f docker-compose.test.yaml up --build
Open:
http://localhost:8080/
Test the backend through the frontend proxy:
curl http://localhost:8080/api/
curl http://localhost:8080/api/healthz
Stop everything:
docker compose -f docker-compose.yaml down
If you started the test override stack, stop it with:
docker compose -f docker-compose.yaml -f docker-compose.test.yaml down
Run with Kubernetes (kind)
Build images:
docker build -t backend:local ./backend
docker build -t frontend:local ./frontend
Create the cluster:
kind create cluster --name cluster --config kind-config.yaml
Load images into kind:
kind load docker-image backend:local --name cluster
kind load docker-image frontend:local --name cluster
Apply manifests:
kubectl apply -k k8s/overlays/local
Check resources:
kubectl get all -n app
Open:
http://localhost:8080/
Delete the cluster:
kind delete cluster --name cluster