From 20299389c673789f72bf00d69ecb65d9ce07e261 Mon Sep 17 00:00:00 2001 From: Marcos Oliveira Date: Wed, 18 Nov 2026 20:37:58 -0500 Subject: [PATCH 1/2] =?UTF-8?q?feat(demo15):=20autoscaling=20under=20a=20c?= =?UTF-8?q?ap=20=E2=80=94=20the=20same=20flash=20sale=20at=203=20and=208?= =?UTF-8?q?=20replicas?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit From a LinkedIn comment: run the same flash sale with a low and a high cap and compare checkout success rate and cost per 1,000 completed orders. Container Apps caps replicas, not nodes. - scripts/flash_sale.py: signs buyers up (not timed), then each buys 1 item over and over. A failed checkout retries the same cart, so every order is 1 item in both runs. top_up gives every run the same starting stock. Works locally and against Azure. - infra/autoscale_demo.py (make flash-sale CAP=3|8, Azure only): prints the most the run can cost and asks first; sets every service's max replicas; turns inventory's switches on only to top up (off again in finally); waits for every new revision; runs the sale; reads Azure Monitor replicas and requests per revision through the 5-min cooldown; prices sale time active, cooldown idle, plus MySQL, at list price; puts the cap back to 3 in finally; saves flashSaleResults.json. - Demo page /patterns/autoscaling shows the recorded runs side by side. Co-Authored-By: Claude Opus 5.5 --- CLAUDE.md | 10 +- Makefile | 6 +- frontend/src/pages/Home.tsx | 2 +- frontend/src/pages/PatternPage.tsx | 2 + frontend/src/pages/Patterns.tsx | 6 +- frontend/src/patterns/content.ts | 23 ++ .../src/patterns/demos/AutoscalingDemo.tsx | 169 +++++++++++++ .../src/patterns/demos/flashSaleResults.json | 10 + infra/autoscale_demo.py | 225 ++++++++++++++++++ scripts/flash_sale.py | 159 +++++++++++++ tests/smoke/test_post_run.py | 12 + tests/unit/test_autoscale_demo.py | 99 ++++++++ 12 files changed, 717 insertions(+), 6 deletions(-) create mode 100644 frontend/src/patterns/demos/AutoscalingDemo.tsx create mode 100644 frontend/src/patterns/demos/flashSaleResults.json create mode 100644 infra/autoscale_demo.py create mode 100644 scripts/flash_sale.py create mode 100644 tests/unit/test_autoscale_demo.py diff --git a/CLAUDE.md b/CLAUDE.md index 4ebd105..a1dec94 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -27,7 +27,7 @@ history, monolith dropped). The full agreed plan is in [`docs/PLAN.md`](docs/PLA - Name prefix: `ms12p` (parent uses `flaskms`). Teardown deletes the whole resource group, so a shared name would delete the other project. -## Current state (complete: 12 of 12 live, plus demos 13 and 14; one Azure run done and torn down, #11) +## Current state (complete: 12 of 12 live, plus demos 13, 14 and 15; one Azure run done and torn down, #11) - Folders: `services/{user,catalog,order,payment,inventory}/` (Flask, one DB each), `gateway/` (FastAPI), `registry/` (FastAPI), `shared/` (`shop_common`), `contracts/`, `frontend/`, `infra/`, `scripts/`, `tests/`. @@ -57,6 +57,14 @@ history, monolith dropped). The full agreed plan is in [`docs/PLAN.md`](docs/PLA `duplicates_skipped` and `not_handled` (in `/api/inventory/events`). Demo switches use `shop_common.flask_support.DemoSwitch` and `switches_off()`. `POST /api/order/sagas//replay` (chaos, own checkout) clears `published_at` so the relay resends the same ids. Page `/patterns/compensation`. +- Demo 15 (autoscaling, from a LinkedIn comment): `scripts/flash_sale.py`: `sign_up` buyers (not timed), then + `sell`: each buyer buys 1 item; a failed checkout retries the SAME cart (no cart growth); `summarize` counts only + 200 as completed. `top_up` brings free stock to a level. `make flash-sale CAP=3` / `CAP=8` (`infra/autoscale_demo.py`, + Azure only) prints the max cost and asks first, sets every service's `--max-replicas`, sets `CHAOS_ENABLED=1` on + inventory only to top up to 2,500 (removed in `finally`), waits for every app's latest revision, runs the sale, waits + out the 5-min cooldown, reads Azure Monitor `Replicas`/`Requests` split by revision, prices sale replicas active and + cooldown replicas idle plus MySQL (`PRICES`, checked 2026-11-18), resets the cap to 3 in `finally`, and writes + `frontend/src/patterns/demos/flashSaleResults.json`. The page `/patterns/autoscaling` shows that file. - Events (pattern 7): `shop_common/events.py` (Redis Stream `shop.events`, consumer groups, at least once). Order writes `outbox_event` in the same transaction; `outbox.py` relays every 1 s; inventory's `consumer.py` commits the hold on OrderConfirmed and dedupes via `consumed_event`. `POST /debug/bus` diff --git a/Makefile b/Makefile index 952236c..ee114fd 100644 --- a/Makefile +++ b/Makefile @@ -1,4 +1,4 @@ -.PHONY: setup run github-identity provision pause resume teardown verify test contracts smoke clean +.PHONY: setup run github-identity provision pause resume teardown verify test contracts smoke flash-sale clean setup: python3.12 scripts/setup.py @@ -44,6 +44,10 @@ contracts: smoke: .venv/bin/python -m pytest tests/smoke -v +# Demo 15, Azure only: the same flash sale under a replica cap. Run CAP=3, then CAP=8. +flash-sale: + .venv/bin/python infra/autoscale_demo.py --cap $(CAP) $(ARGS) + clean: find . -name "instance" -type d -exec rm -rf {} + 2>/dev/null || true find . -name "__pycache__" -type d -exec rm -rf {} + 2>/dev/null || true diff --git a/frontend/src/pages/Home.tsx b/frontend/src/pages/Home.tsx index 96032c0..82ef439 100644 --- a/frontend/src/pages/Home.tsx +++ b/frontend/src/pages/Home.tsx @@ -18,7 +18,7 @@ export default function Home() {

Patterns

-

The 12 patterns. All 12 are live, each with a working demo, plus demo 13 (a slow payment in the middle of checkout) and demo 14 (the saga's undo under timeouts and duplicate events).

+

The 12 patterns. All 12 are live, each with a working demo, plus demo 13 (a slow payment in the middle of checkout), demo 14 (the saga's undo under timeouts and duplicate events) and demo 15 (a flash sale under a replica cap of 3 and of 8).

diff --git a/frontend/src/pages/PatternPage.tsx b/frontend/src/pages/PatternPage.tsx index a30abee..2e1f1cd 100644 --- a/frontend/src/pages/PatternPage.tsx +++ b/frontend/src/pages/PatternPage.tsx @@ -13,6 +13,7 @@ import SagaDemo from "../patterns/demos/SagaDemo"; import ServiceDiscoveryDemo from "../patterns/demos/ServiceDiscoveryDemo"; import SlowPaymentDemo from "../patterns/demos/SlowPaymentDemo"; import CompensationDemo from "../patterns/demos/CompensationDemo"; +import AutoscalingDemo from "../patterns/demos/AutoscalingDemo"; import StatelessDemo from "../patterns/demos/StatelessDemo"; import { PATTERNS } from "../patterns/content"; @@ -31,6 +32,7 @@ const DEMOS: Record ReactNode> = { "ci-cd-pipeline": () => , "slow-payment": () => , compensation: () => , + autoscaling: () => , }; export default function PatternPage() { diff --git a/frontend/src/pages/Patterns.tsx b/frontend/src/pages/Patterns.tsx index 0764e8a..023275c 100644 --- a/frontend/src/pages/Patterns.tsx +++ b/frontend/src/pages/Patterns.tsx @@ -2,15 +2,15 @@ import { Link } from "react-router-dom"; import { PATTERNS } from "../patterns/content"; export default function Patterns() { - const patterns = PATTERNS.filter((p) => p.n <= 12); // demos 13 and 14 are bonuses, not patterns + const patterns = PATTERNS.filter((p) => p.n <= 12); // demos 13-15 are bonuses, not patterns const liveCount = patterns.filter((p) => p.live).length; return (
-

The 12 patterns, plus demos 13 and 14

+

The 12 patterns, plus demos 13, 14 and 15

Each pattern has a page that explains it, says when not to use it, and runs a live demo against the real - services. {liveCount} of {patterns.length} are live. Demo 13 puts patterns 4 and 8 under a slow payment; demo 14 puts the saga's undo under timeouts and duplicate events. + services. {liveCount} of {patterns.length} are live. Demo 13 puts patterns 4 and 8 under a slow payment; demo 14 puts the saga's undo under timeouts and duplicate events; demo 15 runs a flash sale under a replica cap of 3 and of 8.

diff --git a/frontend/src/patterns/content.ts b/frontend/src/patterns/content.ts index ffce541..d3b420d 100644 --- a/frontend/src/patterns/content.ts +++ b/frontend/src/patterns/content.ts @@ -326,6 +326,29 @@ export const PATTERNS: PatternInfo[] = [ ], source: { label: "Microsoft — Compensating Transaction pattern", url: "https://learn.microsoft.com/azure/architecture/patterns/compensating-transaction" }, }, + { + n: 15, + slug: "autoscaling", + name: "Autoscaling under a cap", + what: "Runs the same flash sale with a replica cap of 3 and of 8, and compares success rate and cost per 1,000 orders.", + milestone: "M3", + live: true, + problem: + "Autoscaling adds copies of a service when load rises, but only up to a cap. A low cap keeps the bill small and loses sales at the peak. A high cap keeps sales and costs more, unless something else, such as the database, is the real limit. You only know which by measuring.", + inThisProject: [ + "Every service is a Container App on the Consumption plan: 0.25 vCPU and 0.5 GiB per replica, scaled on HTTP load (10 requests at once per replica), billed per second.", + "make flash-sale CAP=3 sets every service's cap, tops stock up to 2,500 of each product, and runs scripts/flash_sale.py: 80 signed-in buyers each buy 1 item, over and over, for 4 minutes. A failed checkout is retried with the same cart, so every order is 1 item. Then CAP=8 runs the same sale.", + "Afterwards it reads Azure Monitor: replicas per minute and requests per service, during the sale and through the 5-minute cooldown. It prices them at list price (idle rate for the cooldown) and adds the MySQL server for the same time.", + "Kubernetes caps nodes, Container Apps caps replicas: the question is the same, what the cap costs and what it saves.", + "Raised by a reader of the project's LinkedIn post, after demo 14.", + ], + whenNotToUse: [ + "A shop with steady traffic gains little from autoscaling: a fixed size is cheaper to reason about.", + "Raising the cap does not help when a shared piece (here 1 small MySQL server) is the limit: more replicas only queue up at it.", + "Scale-out takes tens of seconds: a sale that peaks in seconds needs capacity warmed up beforehand (min replicas), not a higher cap.", + ], + source: { label: "Microsoft — Scaling in Azure Container Apps", url: "https://learn.microsoft.com/azure/container-apps/scale-app" }, + }, ]; export const SERVICE_NAMES = ["gateway", "user", "catalog", "order", "payment", "inventory"] as const; diff --git a/frontend/src/patterns/demos/AutoscalingDemo.tsx b/frontend/src/patterns/demos/AutoscalingDemo.tsx new file mode 100644 index 0000000..939eeb0 --- /dev/null +++ b/frontend/src/patterns/demos/AutoscalingDemo.tsx @@ -0,0 +1,169 @@ +import { SERVICE_NAMES } from "../content"; +import results from "./flashSaleResults.json"; + +interface AppUsage { + replica_seconds: number; + cooldown_replica_seconds: number; + peak_replicas: number; + requests: number; +} + +interface FlashSaleRun { + cap: number; + buyers: number; + seconds: number; + region: string; + ran_at: string; + attempts: number; + completed: number; + success_rate: number; + by_status: Record; + p50_ms: number; + p95_ms: number; + orders_per_minute: number; + usage: Record; + cost_usd: { replicas: number; requests: number; mysql: number; total: number }; + cost_per_1k_usd: number | null; +} + +const RUNS = results.runs as FlashSaleRun[]; +const PRICES = results.prices; + +function replicaMinutes(run: FlashSaleRun, key: "replica_seconds" | "cooldown_replica_seconds") { + return Math.round(SERVICE_NAMES.reduce((sum, n) => sum + (run.usage[n]?.[key] ?? 0), 0) / 60); +} + +function pct(share: number) { + return `${(share * 100).toFixed(1)}%`; +} + +function usd(value: number | null) { + return value === null ? "–" : `$${value.toFixed(4)}`; +} + +const STATUS_LABEL: Record = { + "202": "payment pending", + "409": "sold out or pending", + "503": "a service was down or its breaker open", + "no answer": "no answer in 30 s", +}; + +function failures(run: FlashSaleRun) { + const lost = Object.entries(run.by_status).filter(([status]) => status !== "200"); + return lost.length === 0 + ? "none" + : lost.map(([status, n]) => `${n} × ${status} (${STATUS_LABEL[status] ?? "error"})`).join(", "); +} + +/** Demo 15: the same flash sale twice in Azure, with a replica cap of 3 and of 8. Recorded, not live. */ +export default function AutoscalingDemo() { + return ( +
+
+

The experiment

+

+ Many buyers sign in, then each adds 1 item and checks out, again and again, for the same time. Azure Container + Apps adds a replica when each replica of a service is handling more than 10 requests at once, up to the cap. Run 1 caps every service at + 3 replicas, run 2 at 8. Nothing else changes: the same 0.25 vCPU replicas, the same single MySQL server. +

+

+ Recorded in Azure with make flash-sale CAP=3 and CAP=8, then torn down: the stack does + not stay up, so this page shows the saved numbers. +

+
+ + {RUNS.length === 0 ? ( +

No run recorded yet.

+ ) : ( + <> +
+ + + + + {RUNS.map((r) => ( + + ))} + + + + + + {RUNS.map((r) => ( + + ))} + + + + {RUNS.map((r) => ( + + ))} + + + + {RUNS.map((r) => ( + + ))} + + + + {RUNS.map((r) => ( + + ))} + + + + {RUNS.map((r) => ( + + ))} + + + + {RUNS.map((r) => ( + + ))} + + + + {RUNS.map((r) => ( + + ))} + + + + {RUNS.map((r) => ( + + ))} + + +
Cap {r.cap}
Checkout success rate + {pct(r.success_rate)} ({r.completed} of {r.attempts}) +
Completed orders per minute{r.orders_per_minute}
Checkout time, median / 95th percentile + {Math.round(r.p50_ms)} ms / {Math.round(r.p95_ms)} ms +
Lost sales (HTTP status){failures(r)}
Peak replicas (gateway, order) + {r.usage.gateway?.peak_replicas ?? "?"}, {r.usage.order?.peak_replicas ?? "?"} +
Replica time, all 6 services: sale / cooldown + {replicaMinutes(r, "replica_seconds")} / {replicaMinutes(r, "cooldown_replica_seconds")} replica-minutes +
Cost of the run: replicas + requests + MySQL + {usd(r.cost_usd.total)} = {usd(r.cost_usd.replicas)} + {usd(r.cost_usd.requests)} +{" "} + {usd(r.cost_usd.mysql)} +
+ Cost per 1,000 completed orders + + {usd(r.cost_per_1k_usd)} +
+
+

+ {RUNS.map((r) => `Cap ${r.cap}: ${r.buyers} buyers for ${r.seconds} s in ${r.region}, ${r.ran_at}.`).join(" ")}{" "} + Both runs start from 2,500 free units of each product. A buyer whose checkout fails pays for the same 1-item + cart again, so every completed order is 1 item. Azure's list prices before the monthly free grant: replicas + during the sale at the active rate (${PRICES.vcpu_second} per vCPU-second, ${PRICES.gib_second} per + GiB-second), replicas in the 5-minute cooldown after it at the idle rate (${PRICES.idle_vcpu_second} per + vCPU-second), ${PRICES.per_million_requests} per million requests, and the MySQL server at $ + {PRICES.mysql_hour} an hour for the same time. +

+ + )} +
+ ); +} diff --git a/frontend/src/patterns/demos/flashSaleResults.json b/frontend/src/patterns/demos/flashSaleResults.json new file mode 100644 index 0000000..b77d654 --- /dev/null +++ b/frontend/src/patterns/demos/flashSaleResults.json @@ -0,0 +1,10 @@ +{ + "prices": { + "vcpu_second": 2.4e-05, + "idle_vcpu_second": 3e-06, + "gib_second": 3e-06, + "per_million_requests": 0.4, + "mysql_hour": 0.017 + }, + "runs": [] +} diff --git a/infra/autoscale_demo.py b/infra/autoscale_demo.py new file mode 100644 index 0000000..131e8b5 --- /dev/null +++ b/infra/autoscale_demo.py @@ -0,0 +1,225 @@ +#!/usr/bin/env python3 +"""make flash-sale CAP=3 (then CAP=8) — demo 15, against a provisioned Azure stack. + +Caps every service at CAP replicas, runs the same flash sale (scripts/flash_sale.py), then reads +how many replicas Azure ran and how many requests it served from Azure Monitor, and prices them. +The result goes into frontend/src/patterns/demos/flashSaleResults.json for the demo page. + +Every run starts from the same stock (2,500 free units of each product), and a buyer whose checkout +fails pays for the same 1-item cart again, so both runs sell orders of the same size. +Restocking needs inventory's demo switches, which are off in Azure: CHAOS_ENABLED=1 is set on +inventory for the run only and removed afterwards, even when the run fails. The cap goes back to 3 +afterwards, also when the run fails. It prints the most the run can cost and asks before starting. +""" +import argparse +import json +import subprocess +import sys +import time +from datetime import datetime, timedelta, timezone +from pathlib import Path + +REPO_ROOT = Path(__file__).resolve().parents[1] +sys.path.insert(0, str(REPO_ROOT / "scripts")) +import httpx # noqa: E402 + +import flash_sale # noqa: E402 +from resume import MAX_REPLICAS_DEFAULT # noqa: E402 +from service_table import AZURE_SERVICES # noqa: E402 + +DEFAULT_CAP = int(MAX_REPLICAS_DEFAULT) # what provision and make resume set + +STATE_FILE = REPO_ROOT / "infra" / ".state.json" +RESULTS_FILE = REPO_ROOT / "frontend" / "src" / "patterns" / "demos" / "flashSaleResults.json" + +# Every app runs 0.25 vCPU and 0.5 GiB per replica (infra/bicep/modules/container-app.bicep). +REPLICA_VCPU = 0.25 +REPLICA_GIB = 0.5 +# List prices, East US, from https://prices.azure.com/api/retail/prices (Azure Container Apps, +# Consumption; Azure Database for MySQL, B1MS compute), checked 2026-11-18. The monthly free grant +# is ignored: it would make both runs read $0. +PRICES = { + "vcpu_second": 0.000024, "idle_vcpu_second": 0.000003, "gib_second": 0.000003, + "per_million_requests": 0.40, "mysql_hour": 0.017, +} +COOLDOWN_SECONDS = 300 # Container Apps keeps extra replicas this long after the load ends +METRICS_DELAY_SECONDS = 180 # Azure Monitor shows a minute's numbers a few minutes later +SESSION_HOURS = 0.5 # MySQL bills from make provision to make teardown: about this long for one run +STOCK_PER_PRODUCT = 2500 # free stock every run starts from, so no run sells out + + +def _value(point: dict, key: str) -> float: + return point.get(key) or 0.0 # Azure Monitor sends null for a minute with no data + + +def replica_usage(metrics: dict) -> dict: + """One app's `az monitor metrics list` answer, 1-minute points, one series per revision -> + replica-seconds, peak replicas, requests. Revisions running side by side are both billed.""" + series = {m["name"]["value"]: m["timeseries"] for m in metrics["value"]} + per_minute: dict = {} + seconds = 0.0 + for revision in series.get("Replicas", []): + for i, point in enumerate(revision["data"]): + seconds += _value(point, "average") * 60 + minute = point.get("timeStamp", i) + per_minute[minute] = per_minute.get(minute, 0.0) + _value(point, "maximum") + requests = sum(_value(p, "total") for revision in series.get("Requests", []) for p in revision["data"]) + return {"replica_seconds": seconds, "peak_replicas": int(max(per_minute.values(), default=0)), + "requests": int(requests)} + + +def _active_replica_second() -> float: + return REPLICA_VCPU * PRICES["vcpu_second"] + REPLICA_GIB * PRICES["gib_second"] + + +def cost_usd(usage: dict[str, dict], mysql_seconds: float) -> dict: + """Replicas during the sale at the active rate, through the cooldown at the idle rate (they + serve nothing then), requests, and the MySQL server for the same time.""" + idle_replica_second = REPLICA_VCPU * PRICES["idle_vcpu_second"] + REPLICA_GIB * PRICES["gib_second"] + replicas = sum(u["replica_seconds"] * _active_replica_second() + + u["cooldown_replica_seconds"] * idle_replica_second for u in usage.values()) + requests = sum(u["requests"] for u in usage.values()) / 1_000_000 * PRICES["per_million_requests"] + mysql = mysql_seconds / 3600 * PRICES["mysql_hour"] + return {"replicas": replicas, "requests": requests, "mysql": mysql, "total": replicas + requests + mysql} + + +def estimate_max_usd(cap: int, seconds: float) -> float: + """The most one run can cost: every service at the cap for the sale and the cooldown, all at the + active rate, plus MySQL for the whole session.""" + return (len(AZURE_SERVICES) * cap * (seconds + COOLDOWN_SECONDS) * _active_replica_second() + + SESSION_HOURS * PRICES["mysql_hour"]) + + +def per_thousand(cost: float, completed: int) -> float | None: + return round(cost / completed * 1000, 4) if completed else None + + +def merge_run(results: dict, run: dict) -> dict: + """A rerun with the same cap replaces the old one; runs stay sorted by cap.""" + runs = [r for r in results.get("runs", []) if r["cap"] != run["cap"]] + [run] + return {**results, "runs": sorted(runs, key=lambda r: r["cap"])} + + +def _az(args: list[str]) -> str: + print(f"$ az {' '.join(args)}") + return subprocess.run(["az", *args, "--output", "json"], capture_output=True, text=True, check=True).stdout + + +def _set_cap(resource_group: str, cap: int) -> None: + for svc in AZURE_SERVICES: + _az(["containerapp", "update", "--name", svc.name, "--resource-group", resource_group, + "--max-replicas", str(cap)]) + + +def _inventory_switches(resource_group: str, on: bool) -> None: + change = ["--set-env-vars", "CHAOS_ENABLED=1"] if on else ["--remove-env-vars", "CHAOS_ENABLED"] + _az(["containerapp", "update", "--name", "inventory", "--resource-group", resource_group, *change]) + + +def _wait_until_ready(resource_group: str, timeout: float = 600) -> None: + """Every update starts a new revision. The sale starts only once every app runs its latest one.""" + deadline = time.monotonic() + timeout + for svc in AZURE_SERVICES: + while True: + app = json.loads(_az(["containerapp", "show", "--name", svc.name, "--resource-group", resource_group])) + props = app["properties"] + if props.get("latestReadyRevisionName") == props.get("latestRevisionName"): + break + if time.monotonic() > deadline: + raise SystemExit(f"{svc.name} never got its new revision ready") + time.sleep(10) + + +def _top_up_when_ready(gateway: str, timeout: float = 300) -> None: + """Restock answers 403 until inventory's new revision (with CHAOS_ENABLED=1) takes the traffic.""" + deadline = time.monotonic() + timeout + while True: + try: + flash_sale.top_up(gateway, STOCK_PER_PRODUCT) + return + except httpx.HTTPError as err: + if time.monotonic() > deadline: + raise SystemExit(f"Restock never worked: {err}") + time.sleep(10) + + +def _metrics(subscription: str, resource_group: str, app: str, start: datetime, end: datetime) -> dict: + resource = f"/subscriptions/{subscription}/resourceGroups/{resource_group}/providers/Microsoft.App/containerApps/{app}" + query = ["monitor", "metrics", "list", "--resource", resource, "--metrics", "Replicas", "Requests", + "--interval", "PT1M", "--aggregation", "Average", "Maximum", "Total", + "--start-time", start.isoformat(), "--end-time", end.isoformat()] + try: # one series per revision, so revisions running side by side are added up + return json.loads(_az([*query, "--filter", "revisionName eq '*'"])) + except subprocess.CalledProcessError: + return json.loads(_az(query)) # the metric has no revision split: Azure adds them up itself + + +def _usage(subscription: str, resource_group: str, start: datetime, end: datetime, cooldown_end: datetime) -> dict: + usage = {} + for svc in AZURE_SERVICES: + sale = replica_usage(_metrics(subscription, resource_group, svc.name, start, end)) + cooldown = replica_usage(_metrics(subscription, resource_group, svc.name, end, cooldown_end)) + usage[svc.name] = {**sale, "cooldown_replica_seconds": cooldown["replica_seconds"], + "requests": sale["requests"] + cooldown["requests"]} + return usage + + +def main() -> int: + parser = argparse.ArgumentParser(description="Demo 15: one flash sale under a replica cap.") + parser.add_argument("--cap", type=int, required=True, help="max replicas per service, e.g. 3 or 8") + parser.add_argument("--buyers", type=int, default=80, help="buyers checking out at the same time") + parser.add_argument("--seconds", type=float, default=240) + parser.add_argument("--yes", action="store_true", help="skip the cost confirmation") + args = parser.parse_args() + if not STATE_FILE.exists(): + print("No infra/.state.json: run make provision first.") + return 1 + state = json.loads(STATE_FILE.read_text()) + resource_group, subscription = state["resource_group"], state["subscription_id"] + gateway = f"https://{state['outputs']['gatewayFqdn']}" + + estimate = estimate_max_usd(args.cap, args.seconds) + print(f"Cap {args.cap}, {args.buyers} buyers for {args.seconds:.0f} s. This run costs at most ${estimate:.2f} " + f"(every service at {args.cap} replicas the whole time, plus MySQL).") + if not args.yes and input("Go ahead? [y/N] ").strip().lower() != "y": + return 1 + + try: + _set_cap(resource_group, args.cap) + _inventory_switches(resource_group, on=True) + try: + _wait_until_ready(resource_group) + _top_up_when_ready(gateway) + buyers = flash_sale.sign_up(gateway, args.buyers) # not timed, not measured + start = datetime.now(timezone.utc) + summary = flash_sale.sell(gateway, buyers, args.seconds) + end = datetime.now(timezone.utc) + finally: + _inventory_switches(resource_group, on=False) + print(json.dumps(summary, indent=2)) + + # The replicas still running through the cooldown are billed too: wait them out, then read. + cooldown_end = end + timedelta(seconds=COOLDOWN_SECONDS) + wait = (cooldown_end - datetime.now(timezone.utc)).total_seconds() + METRICS_DELAY_SECONDS + print(f"Waiting {wait / 60:.0f} min for the cooldown and for Azure Monitor to catch up...") + time.sleep(max(0.0, wait)) + usage = _usage(subscription, resource_group, start, end, cooldown_end) + finally: + if args.cap != DEFAULT_CAP: + _set_cap(resource_group, DEFAULT_CAP) # always, so a failed run never leaves the higher cap + + cost = cost_usd(usage, mysql_seconds=(cooldown_end - start).total_seconds()) + run = {"cap": args.cap, "buyers": args.buyers, "seconds": args.seconds, "region": state["location"], + "ran_at": start.isoformat(timespec="seconds"), **summary, "usage": usage, + "cost_usd": {k: round(v, 4) for k, v in cost.items()}, + "cost_per_1k_usd": per_thousand(cost["total"], summary["completed"])} + results = json.loads(RESULTS_FILE.read_text()) if RESULTS_FILE.exists() else {} + RESULTS_FILE.write_text(json.dumps(merge_run({**results, "prices": PRICES}, run), indent=2) + "\n") + per_1k = "no completed orders" if run["cost_per_1k_usd"] is None else f"${run['cost_per_1k_usd']} per 1,000 orders" + print(f"Cap {args.cap}: {summary['completed']} orders, {summary['success_rate']:.0%} succeeded, " + f"${cost['total']:.4f}, {per_1k}. Saved to {RESULTS_FILE.relative_to(REPO_ROOT)}") + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/scripts/flash_sale.py b/scripts/flash_sale.py new file mode 100644 index 0000000..bd96867 --- /dev/null +++ b/scripts/flash_sale.py @@ -0,0 +1,159 @@ +"""Demo 15: a flash sale. Many signed-in buyers each add 1 item and check out, again and again, +for a fixed time. Works against the local gateway and the Azure one: + + .venv/bin/python scripts/flash_sale.py --gateway http://127.0.0.1:8100 --buyers 5 --seconds 10 --stock 200 + +Prints a JSON summary. --stock needs CHAOS_ENABLED=1 on inventory (on locally under make run). +""" +import argparse +import json +import math +import threading +import time +import uuid +from collections import Counter +from concurrent.futures import ThreadPoolExecutor +from dataclasses import dataclass + +import httpx + +PRODUCTS = range(1, 25) # the catalog's 24 sample products +TIMEOUT = httpx.Timeout(30.0) +RESTOCK_MAX = 1000 # inventory's restock accepts at most this many per call +PENDING_WAIT_SECONDS = 6 # the reconciler settles pending payments every 5 s + + +@dataclass(frozen=True) +class Attempt: + status: int | None # None: no answer (timeout or refused connection) + ms: float + + +def _percentile(values: list[float], share: float) -> float: + ordered = sorted(values) + return ordered[max(0, math.ceil(share * len(ordered)) - 1)] + + +def summarize(attempts: list[Attempt], seconds: float) -> dict: + """Only a 200 is a completed order: 202 is still pending, everything else is a lost sale.""" + completed = sum(1 for a in attempts if a.status == 200) + times = [a.ms for a in attempts] + return { + "attempts": len(attempts), + "completed": completed, + "success_rate": round(completed / len(attempts), 4) if attempts else 0.0, + "by_status": dict(Counter("no answer" if a.status is None else str(a.status) for a in attempts)), + "p50_ms": round(_percentile(times, 0.50), 1) if times else 0.0, + "p95_ms": round(_percentile(times, 0.95), 1) if times else 0.0, + "orders_per_minute": round(completed / seconds * 60, 1) if seconds else 0.0, + } + + +def top_up_amounts(stock: list[dict], target: int) -> dict[int, list[int]]: + """Restock calls that bring each product's free stock to `target` (the API takes 1,000 at most).""" + plan = {} + for row in stock: + missing = target - (row["on_hand"] - row["reserved"]) + if missing > 0: + plan[row["product_id"]] = [RESTOCK_MAX] * (missing // RESTOCK_MAX) + ([missing % RESTOCK_MAX] if missing % RESTOCK_MAX else []) + return plan + + +def top_up(gateway: str, target: int) -> None: + """Every run starts from the same stock, so one run's sales never decide the next run's result.""" + shop = _shop(gateway) + stock = httpx.get(f"{shop}/inventory", timeout=TIMEOUT).raise_for_status().json()["results"] + for product_id, amounts in top_up_amounts([r for r in stock if r["product_id"] in PRODUCTS], target).items(): + for quantity in amounts: + httpx.post(f"{shop}/inventory/{product_id}/restock", json={"quantity": quantity}, + timeout=TIMEOUT).raise_for_status() + + +def _shop(gateway: str) -> str: + return f"{gateway.rstrip('/')}/api/shop" + + +def _sign_up(shop: str) -> dict: + tag = uuid.uuid4().hex[:10] + user = {"username": f"fs{tag}", "password": "flashsale1"} + httpx.post(f"{shop}/user/create", data={**user, "email": f"fs{tag}@example.com"}, timeout=TIMEOUT) + r = httpx.post(f"{shop}/user/login", data=user, timeout=TIMEOUT) + r.raise_for_status() + return {"Authorization": f"Bearer {r.json()['token']}"} + + +def _cart_has_items(client: httpx.Client) -> bool: + try: + return bool(client.get("/order").json().get("result", {}).get("items")) + except (httpx.HTTPError, ValueError): + return True # unknown: retrying the checkout is safe, adding an item is not + + +def buy(client: httpx.Client, first_product: int, until: float, out: list[Attempt]) -> None: + """One buyer: 1 item per order. A failed checkout keeps the cart, so the buyer pays for the same + cart again instead of adding a second item (which would make that order bigger).""" + product, cart_full = first_product, False + while time.monotonic() < until: + started = time.perf_counter() + try: + status = 200 if cart_full else client.post("/order/add-item", data={"product_id": product, "qty": 1}).status_code + added = status == 200 + if added: + status = client.post("/order/checkout").status_code + except httpx.HTTPError: + status, added = None, False + out.append(Attempt(status, (time.perf_counter() - started) * 1000)) # list.append is thread-safe + if status == 200: + cart_full, product = False, product % len(PRODUCTS) + 1 + elif status == 202: + time.sleep(PENDING_WAIT_SECONDS) + cart_full = _cart_has_items(client) + elif status is None or not added: + cart_full = _cart_has_items(client) + else: + cart_full = True + if status == 409: + time.sleep(1) # sold out, or still pending: do not hammer the order service + + +def sign_up(gateway: str, buyers: int) -> list[dict]: + with ThreadPoolExecutor(max_workers=10) as pool: + return list(pool.map(lambda _: _sign_up(_shop(gateway)), range(buyers))) + + +def sell(gateway: str, buyers: list[dict], seconds: float) -> dict: + """Every buyer buys at once for `seconds`; returns the summary.""" + attempts: list[Attempt] = [] + until = time.monotonic() + seconds + clients = [httpx.Client(base_url=_shop(gateway), headers=h, timeout=TIMEOUT) for h in buyers] + threads = [threading.Thread(target=buy, args=(c, i % len(PRODUCTS) + 1, until, attempts)) + for i, c in enumerate(clients)] + for t in threads: + t.start() + for t in threads: + t.join() + for c in clients: + c.close() + return summarize(attempts, seconds) + + +def run(gateway: str, buyers: int, seconds: float) -> dict: + """Signs the buyers up first (not timed), then lets them all buy at once.""" + return sell(gateway, sign_up(gateway, buyers), seconds) + + +def main() -> int: + parser = argparse.ArgumentParser(description=__doc__.splitlines()[0]) + parser.add_argument("--gateway", default="http://127.0.0.1:8100") + parser.add_argument("--buyers", type=int, default=5) + parser.add_argument("--seconds", type=float, default=10) + parser.add_argument("--stock", type=int, default=0, help="first top up each product's free stock to this") + args = parser.parse_args() + if args.stock: + top_up(args.gateway, args.stock) + print(json.dumps(run(args.gateway, args.buyers, args.seconds), indent=2)) + return 0 + + +if __name__ == "__main__": + raise SystemExit(main()) diff --git a/tests/smoke/test_post_run.py b/tests/smoke/test_post_run.py index 97997e7..1f1074e 100644 --- a/tests/smoke/test_post_run.py +++ b/tests/smoke/test_post_run.py @@ -337,3 +337,15 @@ def test_every_process_reports_how_it_runs(): processes = httpx.get(f"{GATEWAY_URL}/api/patterns/runtime").json()["processes"] assert len(processes) == 7 # gateway + 5 services, order twice assert all("uid" in p for p in processes) + + +# --- Demo 15: the flash sale script, locally (the replica caps only exist in Azure) --------------- + +def test_demo_15_the_flash_sale_completes_orders_through_the_gateway(): + import flash_sale + + _require_stack() + flash_sale.top_up(GATEWAY_URL, 50) # a sold-out product answers 409 and stays in the cart + summary = flash_sale.run(GATEWAY_URL, buyers=3, seconds=5) + assert summary["completed"] >= 3 + assert summary["success_rate"] >= 0.9, summary["by_status"] diff --git a/tests/unit/test_autoscale_demo.py b/tests/unit/test_autoscale_demo.py new file mode 100644 index 0000000..a19a994 --- /dev/null +++ b/tests/unit/test_autoscale_demo.py @@ -0,0 +1,99 @@ +"""Demo 15: the same flash sale under a replica cap of 3 and of 8. These cover the numbers the page +shows: success rate, replica-seconds read from Azure Monitor, and cost per 1,000 completed orders.""" +import time + +import httpx + +import autoscale_demo +import flash_sale +from flash_sale import Attempt + + +def test_summary_counts_only_200s_as_completed_and_reports_latency(): + attempts = [Attempt(200, 100.0)] * 6 + [Attempt(503, 50.0)] * 2 + [Attempt(202, 900.0), Attempt(None, 3000.0)] + summary = flash_sale.summarize(attempts, seconds=60) + assert summary["attempts"] == 10 + assert summary["completed"] == 6 + assert summary["success_rate"] == 0.6 + assert summary["by_status"] == {"200": 6, "503": 2, "202": 1, "no answer": 1} + assert summary["p50_ms"] == 100.0 + assert summary["p95_ms"] == 3000.0 + assert summary["orders_per_minute"] == 6.0 + + +def test_summary_of_no_attempts_is_zero_not_a_crash(): + assert flash_sale.summarize([], seconds=60)["success_rate"] == 0.0 + + +def _metric(name, points): + return {"name": {"value": name}, "timeseries": [{"data": points}]} + + +def test_replica_usage_turns_one_minute_averages_into_seconds(): + metrics = {"value": [ + _metric("Replicas", [{"average": 1.0, "maximum": 1.0}, {"average": 2.5, "maximum": 3.0}, {}]), + _metric("Requests", [{"total": 400.0}, {"total": 600.0}]), + ]} + assert autoscale_demo.replica_usage(metrics) == {"replica_seconds": 210.0, "peak_replicas": 3, "requests": 1000} + + +def test_replica_usage_adds_up_revisions_and_survives_empty_minutes(): + """A cap change starts a new revision: both run side by side for a while and both are billed.""" + old = {"data": [{"timeStamp": "t1", "average": 2.0, "maximum": 2.0}, {"timeStamp": "t2", "average": None}]} + new = {"data": [{"timeStamp": "t1", "average": 1.0, "maximum": 2.0}, {"timeStamp": "t2", "average": 3.0, "maximum": 3.0}]} + metrics = {"value": [{"name": {"value": "Replicas"}, "timeseries": [old, new]}, + {"name": {"value": "Requests"}, "timeseries": []}]} + assert autoscale_demo.replica_usage(metrics) == {"replica_seconds": 360.0, "peak_replicas": 4, "requests": 0} + + +def test_cost_prices_the_sale_active_the_cooldown_idle_and_adds_mysql(): + usage = {"gateway": {"replica_seconds": 1000.0, "cooldown_replica_seconds": 1000.0, "peak_replicas": 3, + "requests": 1_000_000}, + "order": {"replica_seconds": 1000.0, "cooldown_replica_seconds": 0.0, "peak_replicas": 3, "requests": 0}} + cost = autoscale_demo.cost_usd(usage, mysql_seconds=3600) + # sale: 2000 s x (0.25 x $0.000024 + 0.5 x $0.000003) = $0.015 + # cooldown: 1000 s x (0.25 x $0.000003 + 0.5 x $0.000003) = $0.00225 + # requests: 1M x $0.40/M = $0.40; MySQL B1ms: 1 hour x $0.017 + assert {k: round(v, 6) for k, v in cost.items()} == { + "replicas": 0.01725, "requests": 0.4, "mysql": 0.017, "total": 0.43425} + + +def test_the_estimate_before_a_run_assumes_every_service_sits_at_the_cap(): + # 6 apps x 8 replicas x (240 s + 300 s cooldown) at the active rate, plus MySQL for 30 minutes + assert round(autoscale_demo.estimate_max_usd(cap=8, seconds=240), 4) == round( + 6 * 8 * 540 * 0.0000075 + 0.5 * 0.017, 4) + + +def test_top_up_brings_every_product_to_the_same_level_in_steps_the_api_accepts(): + rows = [{"product_id": 1, "on_hand": 30, "reserved": 5}, {"product_id": 2, "on_hand": 2600, "reserved": 0}, + {"product_id": 3, "on_hand": 100, "reserved": 0}] + assert flash_sale.top_up_amounts(rows, target=2500) == {1: [1000, 1000, 475], 3: [1000, 1000, 400]} + + +def test_cost_per_thousand_orders(): + assert autoscale_demo.per_thousand(0.5, completed=2000) == 0.25 + assert autoscale_demo.per_thousand(0.5, completed=0) is None + + +def test_a_rerun_replaces_the_run_with_the_same_cap(): + results = {"runs": [{"cap": 8, "completed": 1}, {"cap": 3, "completed": 1}]} + merged = autoscale_demo.merge_run(results, {"cap": 3, "completed": 2}) + assert merged["runs"] == [{"cap": 3, "completed": 2}, {"cap": 8, "completed": 1}] + + +def _shop(checkout_statuses: list[int], calls: list[str]) -> httpx.Client: + def handler(request: httpx.Request) -> httpx.Response: + calls.append(request.url.path) + if request.url.path.endswith("/checkout"): + return httpx.Response(checkout_statuses.pop(0) if checkout_statuses else 200) + return httpx.Response(200, json={"result": {"items": []}}) + return httpx.Client(transport=httpx.MockTransport(handler), base_url="http://shop") + + +def test_a_buyer_retries_the_same_cart_after_a_failed_checkout(): + """A failed checkout keeps the cart: adding another item would make the next order bigger.""" + calls: list[str] = [] + out: list[Attempt] = [] + flash_sale.buy(_shop([503, 503, 200], calls), first_product=1, until=time.monotonic() + 0.1, out=out) + assert calls[:5] == ["/order/add-item", "/order/checkout", "/order/checkout", "/order/checkout", "/order/add-item"] + assert [a.status for a in out[:3]] == [503, 503, 200] From ca197c9aa83d3680b27ec419c2af93ce9592a302 Mon Sep 17 00:00:00 2001 From: Marcos Oliveira Date: Wed, 18 Nov 2026 23:03:57 -0500 Subject: [PATCH 2/2] =?UTF-8?q?feat(demo15):=20record=20the=20Azure=20runs?= =?UTF-8?q?=20=E2=80=94=20cap=208=20sells=204x=20the=20orders=20at=20half?= =?UTF-8?q?=20the=20cost=20per=201,000?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Cap 3: 50.3% of checkouts succeeded (1,289 orders), $0.032, $0.025 per 1,000 orders. - Cap 8: 99.2% (5,193 orders), $0.067, $0.013 per 1,000 orders. - Fixes found in the run: sign-up retries a busy user service (it is not timed), and a buyer whose earlier checkout went through after a timeout (404, no open order) starts a new cart. - README section, screenshot, 404 label on the page. Co-Authored-By: Claude Opus 5.5 --- README.md | 35 ++++- docs/screenshots/p15-autoscaling.jpg | Bin 0 -> 58834 bytes .../src/patterns/demos/AutoscalingDemo.tsx | 3 +- .../src/patterns/demos/flashSaleResults.json | 131 +++++++++++++++++- scripts/flash_sale.py | 26 +++- tests/unit/test_autoscale_demo.py | 22 +++ 6 files changed, 204 insertions(+), 13 deletions(-) create mode 100644 docs/screenshots/p15-autoscaling.jpg diff --git a/README.md b/README.md index a03671e..a382964 100644 --- a/README.md +++ b/README.md @@ -6,8 +6,9 @@ can click. > **Status: complete.** All 12 patterns are live, each with a working demo, locally and in one > real Azure run: provision, deploy through GitHub Actions with OIDC, smoke tests, screenshots, -> teardown. Demos 13 (a slow payment in the middle of checkout) and 14 (the saga's undo under -> timeouts and duplicate events) came from readers' comments on the project's LinkedIn post. The foundation is copied from +> teardown. Demos 13 (a slow payment in the middle of checkout), 14 (the saga's undo under +> timeouts and duplicate events) and 15 (a flash sale under a replica cap of 3 and of 8, run in +> Azure) came from readers' comments on the project's LinkedIn post. The foundation is copied from > [Azure-Ecommerce-Monolith-Microservices-Migration](https://github.com/MAOFILHO/Azure-Ecommerce-Monolith-Microservices-Migration). ## Project summary @@ -28,15 +29,16 @@ React frontend with one page per pattern. Every demo calls the real services: no | M3b: delivery and the Azure run | 3 | [#12](https://github.com/MAOFILHO/Microservices-12-Patterns/pull/12), [#13](https://github.com/MAOFILHO/Microservices-12-Patterns/pull/13), [#14](https://github.com/MAOFILHO/Microservices-12-Patterns/pull/14) | | Demo 13: a slow payment mid-checkout | 4 and 8, under a timeout | [#16](https://github.com/MAOFILHO/Microservices-12-Patterns/pull/16) | | Demo 14: compensation under fire | 7 and 8, under timeouts and duplicates | [#17](https://github.com/MAOFILHO/Microservices-12-Patterns/pull/17) | +| Demo 15: autoscaling under a cap | 9 and 10, under a flash sale in Azure | [#18](https://github.com/MAOFILHO/Microservices-12-Patterns/pull/18) | M3b was planned as 7 GitHub issues ([#5 to #11](https://github.com/MAOFILHO/Microservices-12-Patterns/issues?q=is%3Aissue)), all closed. **How it was checked.** -- **194 unit tests** across 8 suites, each in its own virtualenv, built test-first from M3a on. +- **206 unit tests** across 8 suites, each in its own virtualenv, built test-first from M3a on. - **Pact contract tests**: the order service's contracts with payment, catalog and inventory, verified against the real providers in CI. -- **28 local smoke tests** against the running stack, and **4 Azure smoke tests** against the real +- **29 local smoke tests** against the running stack, and **4 Azure smoke tests** against the real deployment. - **CI on every pull request** runs only what the change touches; every image is built for linux/amd64, started, and rejected if it runs as root. `main` requires the "CI ok" check. @@ -64,6 +66,7 @@ or the cheapest SKUs, with a $25/month budget alert, then torn down and verified | 12 | [Service Discovery](#12-service-discovery) | Finds service instances automatically at runtime | M2 | | 13 | [Saga under a slow payment](#13-saga-under-a-slow-payment) | Follows the money and the stock when payment times out mid-checkout | Demo 13 | | 14 | [Compensation under fire](#14-compensation-under-fire) | Times out and duplicates the saga's undo, then checks the stock ends where it began | Demo 14 | +| 15 | [Autoscaling under a cap](#15-autoscaling-under-a-cap) | Runs the same flash sale with a replica cap of 3 and of 8, and compares success rate and cost per 1,000 orders | Demo 15 | ## Architecture @@ -233,6 +236,30 @@ Here the hold arrived late: the release came first, the stock went 473 to 473, n Demo 14: inventory holds slowly; the saga's release arrives first, the late hold holds nothing, and the stock ends where it began +### 15. Autoscaling under a cap +A third reader asked how a node cap changes cloud cost: run the same flash sale with a low and a +high cap, and compare checkout success rate and cost per 1,000 completed orders. Container Apps +caps replicas, not nodes, so `make flash-sale CAP=3` and `CAP=8` cap every service at that many +replicas. 80 buyers each buy 1 item, over and over, for 4 minutes, from the same starting stock. A +failed checkout is retried with the same cart, so every order is 1 item. Cost is read from Azure +Monitor and priced at list price: replicas during the sale and the 5-minute cooldown after it, +requests, and the MySQL server for the same time. + +| | Cap 3 | Cap 8 | +|---|---|---| +| Checkout success rate | 50.3% (1,289 of 2,563) | 99.2% (5,193 of 5,235) | +| Completed orders per minute | 322 | 1,298 | +| Median checkout time | 8.5 s | 2.5 s | +| Cost of the run | $0.032 | $0.067 | +| **Cost per 1,000 completed orders** | **$0.025** | **$0.013** | + +The higher cap cost 2.1 times as much and sold 4 times as many orders, so each order cost about +half as much. The single small MySQL server was not the limit at this load; the gateway and order +service, capped at 3 replicas, were. One run each, 19 November 2026, East US: a trend, not a +benchmark. + +Demo 15: the same flash sale at a cap of 3 and of 8 replicas; cap 8 completes 99% of checkouts and halves the cost per 1,000 orders + ## Run locally (no Docker) ```bash diff --git a/docs/screenshots/p15-autoscaling.jpg b/docs/screenshots/p15-autoscaling.jpg new file mode 100644 index 0000000000000000000000000000000000000000..d90a596bd656f59e4eef66cec14f68da08ddbe32 GIT binary patch literal 58834 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 bW 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 literal 0 HcmV?d00001 diff --git a/frontend/src/patterns/demos/AutoscalingDemo.tsx b/frontend/src/patterns/demos/AutoscalingDemo.tsx index 939eeb0..347a264 100644 --- a/frontend/src/patterns/demos/AutoscalingDemo.tsx +++ b/frontend/src/patterns/demos/AutoscalingDemo.tsx @@ -43,7 +43,8 @@ function usd(value: number | null) { const STATUS_LABEL: Record = { "202": "payment pending", - "409": "sold out or pending", + "404": "no cart left: an earlier try went through after a timeout", + "409": "sold out, pending, or a checkout already running", "503": "a service was down or its breaker open", "no answer": "no answer in 30 s", }; diff --git a/frontend/src/patterns/demos/flashSaleResults.json b/frontend/src/patterns/demos/flashSaleResults.json index b77d654..6076464 100644 --- a/frontend/src/patterns/demos/flashSaleResults.json +++ b/frontend/src/patterns/demos/flashSaleResults.json @@ -6,5 +6,134 @@ "per_million_requests": 0.4, "mysql_hour": 0.017 }, - "runs": [] + "runs": [ + { + "cap": 3, + "buyers": 80, + "seconds": 240, + "region": "eastus", + "ran_at": "2026-11-19T03:25:26+00:00", + "attempts": 2563, + "completed": 1289, + "success_rate": 0.5029, + "by_status": { + "503": 1076, + "409": 95, + "202": 1, + "200": 1289, + "404": 102 + }, + "p50_ms": 8523.6, + "p95_ms": 14713.3, + "orders_per_minute": 322.2, + "usage": { + "user": { + "replica_seconds": 240.0, + "peak_replicas": 1, + "requests": 96, + "cooldown_replica_seconds": 210.0 + }, + "catalog": { + "replica_seconds": 210.0, + "peak_replicas": 2, + "requests": 1980, + "cooldown_replica_seconds": 600.0 + }, + "order": { + "replica_seconds": 450.0, + "peak_replicas": 3, + "requests": 3892, + "cooldown_replica_seconds": 900.0 + }, + "payment": { + "replica_seconds": 90.0, + "peak_replicas": 1, + "requests": 1406, + "cooldown_replica_seconds": 600.0 + }, + "inventory": { + "replica_seconds": 330.0, + "peak_replicas": 3, + "requests": 2586, + "cooldown_replica_seconds": 1080.0 + }, + "gateway": { + "replica_seconds": 540.0, + "peak_replicas": 3, + "requests": 4162, + "cooldown_replica_seconds": 900.0 + } + }, + "cost_usd": { + "replicas": 0.0236, + "requests": 0.0056, + "mysql": 0.0026, + "total": 0.0318 + }, + "cost_per_1k_usd": 0.0247 + }, + { + "cap": 8, + "buyers": 80, + "seconds": 240, + "region": "eastus", + "ran_at": "2026-11-19T03:43:17+00:00", + "attempts": 5235, + "completed": 5193, + "success_rate": 0.992, + "by_status": { + "200": 5193, + "503": 22, + "404": 20 + }, + "p50_ms": 2543.1, + "p95_ms": 9626.2, + "orders_per_minute": 1298.2, + "usage": { + "user": { + "replica_seconds": 240.0, + "peak_replicas": 1, + "requests": 119, + "cooldown_replica_seconds": 240.0 + }, + "catalog": { + "replica_seconds": 420.0, + "peak_replicas": 3, + "requests": 5213, + "cooldown_replica_seconds": 900.0 + }, + "order": { + "replica_seconds": 1290.0, + "peak_replicas": 8, + "requests": 10448, + "cooldown_replica_seconds": 2400.0 + }, + "payment": { + "replica_seconds": 390.0, + "peak_replicas": 3, + "requests": 5213, + "cooldown_replica_seconds": 900.0 + }, + "inventory": { + "replica_seconds": 480.0, + "peak_replicas": 4, + "requests": 5213, + "cooldown_replica_seconds": 1680.0 + }, + "gateway": { + "replica_seconds": 1290.0, + "peak_replicas": 8, + "requests": 10551, + "cooldown_replica_seconds": 2400.0 + } + }, + "cost_usd": { + "replicas": 0.05, + "requests": 0.0147, + "mysql": 0.0026, + "total": 0.0673 + }, + "cost_per_1k_usd": 0.013 + } + ] } diff --git a/scripts/flash_sale.py b/scripts/flash_sale.py index bd96867..4871617 100644 --- a/scripts/flash_sale.py +++ b/scripts/flash_sale.py @@ -21,6 +21,8 @@ TIMEOUT = httpx.Timeout(30.0) RESTOCK_MAX = 1000 # inventory's restock accepts at most this many per call PENDING_WAIT_SECONDS = 6 # the reconciler settles pending payments every 5 s +SIGN_UP_TRIES = 6 +SIGN_UP_RETRY_SECONDS = 3 @dataclass(frozen=True) @@ -73,13 +75,21 @@ def _shop(gateway: str) -> str: return f"{gateway.rstrip('/')}/api/shop" -def _sign_up(shop: str) -> dict: +def sign_up_one(client: httpx.Client) -> dict: + """Creates and logs in one buyer. Retried: a busy user service (password hashing is slow on a + 0.25 vCPU replica) may answer 503 while it scales up, and signing up is not part of the sale.""" tag = uuid.uuid4().hex[:10] user = {"username": f"fs{tag}", "password": "flashsale1"} - httpx.post(f"{shop}/user/create", data={**user, "email": f"fs{tag}@example.com"}, timeout=TIMEOUT) - r = httpx.post(f"{shop}/user/login", data=user, timeout=TIMEOUT) - r.raise_for_status() - return {"Authorization": f"Bearer {r.json()['token']}"} + for attempt in range(SIGN_UP_TRIES): + try: + client.post("/user/create", data={**user, "email": f"fs{tag}@example.com"}) + r = client.post("/user/login", data=user) + if r.status_code == 200: + return {"Authorization": f"Bearer {r.json()['token']}"} + except httpx.HTTPError: + pass + time.sleep(SIGN_UP_RETRY_SECONDS * (attempt + 1)) + raise SystemExit(f"Could not sign up a buyer after {SIGN_UP_TRIES} tries") def _cart_has_items(client: httpx.Client) -> bool: @@ -105,6 +115,8 @@ def buy(client: httpx.Client, first_product: int, until: float, out: list[Attemp out.append(Attempt(status, (time.perf_counter() - started) * 1000)) # list.append is thread-safe if status == 200: cart_full, product = False, product % len(PRODUCTS) + 1 + elif status == 404 and added: # no open order: an earlier checkout went through after all + cart_full = False elif status == 202: time.sleep(PENDING_WAIT_SECONDS) cart_full = _cart_has_items(client) @@ -117,8 +129,8 @@ def buy(client: httpx.Client, first_product: int, until: float, out: list[Attemp def sign_up(gateway: str, buyers: int) -> list[dict]: - with ThreadPoolExecutor(max_workers=10) as pool: - return list(pool.map(lambda _: _sign_up(_shop(gateway)), range(buyers))) + with httpx.Client(base_url=_shop(gateway), timeout=TIMEOUT) as client, ThreadPoolExecutor(max_workers=4) as pool: + return list(pool.map(lambda _: sign_up_one(client), range(buyers))) def sell(gateway: str, buyers: list[dict], seconds: float) -> dict: diff --git a/tests/unit/test_autoscale_demo.py b/tests/unit/test_autoscale_demo.py index a19a994..39ab938 100644 --- a/tests/unit/test_autoscale_demo.py +++ b/tests/unit/test_autoscale_demo.py @@ -97,3 +97,25 @@ def test_a_buyer_retries_the_same_cart_after_a_failed_checkout(): flash_sale.buy(_shop([503, 503, 200], calls), first_product=1, until=time.monotonic() + 0.1, out=out) assert calls[:5] == ["/order/add-item", "/order/checkout", "/order/checkout", "/order/checkout", "/order/add-item"] assert [a.status for a in out[:3]] == [503, 503, 200] + + +def test_sign_up_waits_out_a_busy_user_service(monkeypatch): + """Signing up is not timed: a 503 from a user service still scaling up is retried, not fatal.""" + logins = [503, 503, 200] + + def handler(request: httpx.Request) -> httpx.Response: + if request.url.path.endswith("/login"): + status = logins.pop(0) + return httpx.Response(status, json={"token": "t"} if status == 200 else {}) + return httpx.Response(201) + + monkeypatch.setattr(flash_sale, "SIGN_UP_RETRY_SECONDS", 0) + with httpx.Client(transport=httpx.MockTransport(handler), base_url="http://shop") as client: + assert flash_sale.sign_up_one(client) == {"Authorization": "Bearer t"} + + +def test_a_buyer_whose_order_went_through_after_all_starts_a_new_cart(): + """A checkout can time out at the gateway yet complete: the retry then finds no open order (404).""" + calls: list[str] = [] + flash_sale.buy(_shop([503, 404, 200], calls), first_product=1, until=time.monotonic() + 0.1, out=[]) + assert calls[:5] == ["/order/add-item", "/order/checkout", "/order/checkout", "/order/add-item", "/order/checkout"]