restaurant-admin-web/docs/runbooks/containerization.md

Containerization Runbook

Image Build

docker build -t agilewebs/restaurant-admin-web:dev .

Local Run

docker run --rm -p 8080:8080 \
  -e API_BASE_URL=http://host.docker.internal:8080 \
  -e THALOS_AUTH_BASE_URL=http://host.docker.internal:22080 \
  -e THALOS_DEFAULT_RETURN_URL=http://localhost:23480/config \
  -e THALOS_DEFAULT_TENANT_ID=demo-tenant \
  --name restaurant-admin-web agilewebs/restaurant-admin-web:dev

Runtime Configuration Strategy

• Build-time fallback: VITE_API_BASE_URL
• Runtime override: container env API_BASE_URL
• Runtime file generated at startup: /runtime-config.js
• Central OIDC login context is configured through runtime env vars, not hardcoded per build.

Health Check

curl -f http://localhost:8080/