kitchen-service/docs/runbooks/containerization.md

1.3 KiB

Containerization Runbook

Image Build

If the repo consumes internal packages from Gitea, pass feed credentials as build args.

docker build   --build-arg NUGET_FEED_USERNAME=<gitea-login>   --build-arg NUGET_FEED_TOKEN=<gitea-token>   -t agilewebs/kitchen-service:dev .

Local Run

docker run --rm -p 8080:8080 -e KitchenDal__BaseUrl=http://kitchen-dal:8080 -e OperationsDal__BaseUrl=http://operations-dal:8080 --name kitchen-service agilewebs/kitchen-service:dev

Health Probe

  • Path: /health
  • Fallback path: /healthz
  • Port: 8080

Runtime Notes

  • Exposes persisted queue and board endpoints for kitchen operators.
  • Exposes claim, priority, and transition endpoints over linked kitchen tickets.
  • Requires access to both the kitchen DAL host and the operations DAL host.

Health Endpoint Consistency

  • Canonical probe: /health
  • Compatibility probe: /healthz
  • Container port: 8080

Demo Integration

  • Participates in: restaurant demo compose stack.
  • Integration artifact path: greenfield/demo/restaurant/docker-compose.yml

Known Limitations

  • Payment opening remains owned by operations-service.
  • Demo PostgreSQL seeds validate integration contracts and smoke determinism, but do not yet imply full persistence implementation parity.