netgrif/podinfo repository overview

⁠podinfo

A deliberately minimal, dependency-free Node.js web app for teaching and demoing how Kubernetes works.

On the root path (/) it renders a page showing:

• Pod identity — pod name, pod IP, pod UID, namespace, node name, and service account (populated via the Kubernetes Downward API)
• Client/request info — remote socket address and X-Forwarded-For header
• Runtime info — uptime, Node.js version, CPU/memory
• All environment variables and all request headers
• A color-coded banner with a random instance ID, so scaling to multiple replicas and refreshing visually shows load balancing across pods

⁠Endpoints

• / — HTML dashboard
• /api — same data as JSON
• /health — liveness probe
• /ready — readiness probe

⁠Quick start

docker run -p 8080:8080 netgrif/podinfo:latest

Then open http://localhost:8080⁠

⁠Kubernetes

Designed to be run with the Downward API injecting POD_NAME, POD_IP, POD_NAMESPACE, POD_UID, POD_SERVICE_ACCOUNT, and NODE_NAME as environment variables.

Great for demonstrating: load balancing, ConfigMaps/Secrets as env vars, rolling updates, self-healing, readiness vs. liveness probes, and Horizontal Pod Autoscaling.