Files
pikasTech-HWLAB/deploy/master-edge/README.md
T
Lyon a1c3cb58da feat: add deploy contract dry-run plan
Refs #67

Merged by commander after reviewing Code Queue task codex_1779422774244_1. Adds deploy.json public endpoint/frp/k3s/health source fields and dry-run validation. Follow-up: align deploy.json commit/image desired state with the current DEV runtime before using it as apply truth.
2026-05-22 12:28:34 +08:00

28 lines
1.1 KiB
Markdown

# Master Edge DEV Contract
The master edge exposes only the DEV acceptance endpoints for this skeleton:
```text
frontend: http://74.48.78.17:16666
api/edge: http://74.48.78.17:16667
```
Health ownership:
- `hwlab-edge-proxy`: accepts public DEV traffic and exposes `/health/live`.
- `hwlab-router`: owns edge reachability routing and exposes `/health/live`.
- `hwlab-tunnel-client`: owns D601-to-master frp client status and exposes
`/health/live`.
- `hwlab-cloud-api`: receives proxied API traffic and exposes `/health/live`.
- `hwlab-cloud-web`: reads cloud APIs only; it does not control hardware.
- `hwlab-agent-mgr` and `hwlab-agent-worker`: own agent session and worker
session health boundaries.
- `hwlab-gateway-simu`, `hwlab-box-simu`, and `hwlab-patch-panel`: own DEV
simulator and patch-panel health boundaries.
PROD is intentionally gated off for this task.
`deploy/deploy.json` is the source for the public endpoints, FRP proxy ports,
k3s service mappings, and health path. The dry-run renderer validates these
files only and does not perform a real edge apply or restart.