SkyPurza

Open-core multi-cloud GPU broker. The OSS broker follows the SkyPilot open standard (task YAML accepted verbatim, spz CLI verb parity); closed platform services (accounting, dispatch, observability, console) attach through explicit extension points.

• Architecture — components, broker data flow, optimizer failover, the open-core extension seam, and the deployed beta shape, with diagrams.
• Runbook — one page per alarm (meaning → symptoms → diagnosis → remediation) plus the manual processes: credentials, smoke tests, deploy/rollback, canary pause.
• Testing — the full test pyramid, what each tier protects, and how to run every lane.
• API — the live interactive Swagger UI for the beta endpoint, embedded.
• Make targets — the single entry point, generated from make help on every docs build.

Live endpoints

What	URL
Beta API landing page	https://beta.skypurza.ranarhi.people.aws.dev
Interactive API docs (Swagger UI)	https://beta.skypurza.ranarhi.people.aws.dev/docs
OpenAPI document	https://beta.skypurza.ranarhi.people.aws.dev/openapi.json
This docs site	https://docs.beta.skypurza.ranarhi.people.aws.dev

Quick start

make help         # list every workflow (build, test, deploy, docs, smoke)
make ci           # full hermetic CI gate — no credentials needed
make docs-serve   # this site, locally, with live reload

Source of record

Development lives in the local shared hpc.git (projects/skypilot/skypurza); a CodeCommit repo exists only as the CI/CD pipeline source (D17). Every commit is prefixed skypurza:.