centra/photoncloud-monorepo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
photoncloud-monorepo/apigateway/README.md

995 B
Raw Blame History

APIGateway

apigateway is UltraCloud's supported external API and proxy surface for auth-aware and credit-aware upstream traffic.

Supported product shape

APIGateway is supported as stateless replicated instances behind an external L4 or VIP layer; live in-process reload is not part of the product contract.

  • Config distribution is restart-based. Render routes, auth providers, and credit providers from Nix or generated cluster state, then replace or restart the process.
  • Scale-out is supported by running multiple identical instances behind FiberLB or another L4 or VIP distribution layer.
  • The release-facing proof remains nix run ./nix/test-cluster#cluster -- fresh-matrix, which validates the shipped single gateway-node composition on node06.

Explicit non-goals

  • hot route reload through an admin API or SIGHUP
  • in-process config gossip or leader election between gateway replicas
  • a claim that every HA layout is directly release-proven in the current harness