thalos-bff/docs/runbooks/containerization.md
José René White Enciso be41225087 chore(thalos-bff): add container run assets
Why: align BFF runtime packaging and remove cross-repo proto coupling in container builds.

What: add Docker assets and runbook, map /health, and vendor grpc proto locally.

Rule: keep technical intent only and avoid orchestration references.
2026-03-08 14:34:12 -06:00

698 B

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

Local Run

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

Health Probe

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

Runtime Notes

  • Requires ThalosService__GrpcAddress to target thalos-service in distributed runs.
  • gRPC client contract protobuf is vendored at src/Thalos.Bff.Rest/Protos/identity_runtime.proto to keep image builds repo-local.