AgileWebs/furniture-bff
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
69267c228f
furniture-bff/docs/runbooks/containerization.md
José René White Enciso f9a0df0576 feat(furniture): add bff runtime updates 
Why: baseline pending runtime edge and container assets before next wave.

What: add local grpc proto usage, runtime endpoint updates, and repo docs/docker assets.

Rule: keep technical intent and align repository workflow.
2026-03-08 14:59:42 -06:00

1.2 KiB
Raw Blame History

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/furniture-bff:dev .

Local Run

docker run --rm -p 8080:8080 --name furniture-bff agilewebs/furniture-bff:dev

Health Probe

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

Runtime Notes

  • Requires FurnitureService__GrpcAddress to target furniture-service in distributed runs.
  • gRPC client contract protobuf is vendored at src/Furniture.Bff.Rest/Protos/furniture_runtime.proto to keep image builds repo-local.

Health Endpoint Consistency

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

Demo Integration

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

Known Limitations

  • Current runtime adapters are still predominantly in-memory for deterministic local/demo behavior.
  • Demo PostgreSQL seeds validate integration contracts and smoke determinism, but do not yet imply full persistence implementation parity.