diff --git a/docs/runbooks/local-demo.md b/docs/runbooks/local-demo.md index 3f12688..9dfa061 100644 --- a/docs/runbooks/local-demo.md +++ b/docs/runbooks/local-demo.md @@ -14,6 +14,18 @@ Expected endpoints: - readiness: http://localhost:8001/health/ready/full - metrics: http://localhost:8001/metrics +## Verify The API + +After the stack is ready, open another PowerShell window for verification. Use +`curl.exe` so the command invokes curl directly instead of PowerShell's `curl` +alias: + +```powershell +curl.exe -sS "http://localhost:8001/health/live" +curl.exe -sS "http://localhost:8001/health/ready" +curl.exe -sS "http://localhost:8001/health/ready/full" +``` + ## Python Test Setup ```powershell @@ -31,3 +43,20 @@ Get-Content examples/job.sleep.json Get-Content examples/job.inference.json Get-Content examples/job.gpu_demo.json ``` + +Submit the CPU-only sleep job and capture the response: + +```powershell +$job = curl.exe -sS -X POST "http://localhost:8001/v1/jobs" -H "Content-Type: application/json" --data "@examples/job.sleep.json" | ConvertFrom-Json +$job +``` + +Inspect the job status with the returned `job_id`: + +```powershell +curl.exe -sS "http://localhost:8001/v1/jobs/$($job.job_id)" +``` + +For PowerShell examples, prefer `--data "@file.json"` over inline JSON. It +avoids quoting differences and keeps the payload aligned with the checked-in +fixtures under `examples/`.