From d1a6ade101890b90f0b490e55b238d806be7daf2 Mon Sep 17 00:00:00 2001 From: alexmnrs Date: Sat, 27 Jun 2026 13:13:43 +0200 Subject: [PATCH 1/2] Clarify PowerShell local demo steps --- docs/runbooks/local-demo.md | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) diff --git a/docs/runbooks/local-demo.md b/docs/runbooks/local-demo.md index 3f12688..cce30e8 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 id: + +```powershell +curl.exe -sS "http://localhost:8001/v1/jobs/$($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/`. From f4bdf69a554a1c5ccb5a673a3fa48b535ee02d0d Mon Sep 17 00:00:00 2001 From: alexmnrs Date: Mon, 29 Jun 2026 17:48:24 +0200 Subject: [PATCH 2/2] docs: use job_id in PowerShell status example --- docs/runbooks/local-demo.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/runbooks/local-demo.md b/docs/runbooks/local-demo.md index cce30e8..9dfa061 100644 --- a/docs/runbooks/local-demo.md +++ b/docs/runbooks/local-demo.md @@ -51,10 +51,10 @@ $job = curl.exe -sS -X POST "http://localhost:8001/v1/jobs" -H "Content-Type: ap $job ``` -Inspect the job status with the returned id: +Inspect the job status with the returned `job_id`: ```powershell -curl.exe -sS "http://localhost:8001/v1/jobs/$($job.id)" +curl.exe -sS "http://localhost:8001/v1/jobs/$($job.job_id)" ``` For PowerShell examples, prefer `--data "@file.json"` over inline JSON. It