centra/photoncloud-monorepo
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
photoncloud-monorepo/apigateway
History
Exact
centra c1d4178a52 Establish baseline product surface and proof lanes
2026-04-10 19:28:44 +09:00
..
crates Establish baseline product surface and proof lanes 2026-04-10 19:28:44 +09:00
Cargo.lock Implement host lifecycle orchestration and distributed storage restructuring 2026-03-27 12:14:12 +09:00
Cargo.toml nix-nos削除 2026-04-04 16:33:03 +09:00
README.md Establish baseline product surface and proof lanes 2026-04-10 19:28:44 +09:00

README.md

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