thundercode commited on
Commit
944cdb9
Β·
verified Β·
1 Parent(s): baf857b

release: add docs/DEPLOYMENT.md

Browse files
Files changed (1) hide show
  1. docs/DEPLOYMENT.md +9 -3
docs/DEPLOYMENT.md CHANGED
@@ -18,6 +18,12 @@ claim carries the file it came from.
18
  > the monorepo's `deploy/render/main.py` is an earlier, tunnel-less revision. Edits must go to the
19
  > three real repositories, never to the local `deploy/` tree.
20
 
 
 
 
 
 
 
21
  **Companions.** [`architecture/02-deployment-topology.md`](architecture/02-deployment-topology.md)
22
  (the long-form topology treatment), [`OPERATIONS.md`](OPERATIONS.md) (running the live system),
23
  [`SECURITY.md`](SECURITY.md) (the trust boundary),
@@ -70,7 +76,7 @@ Read from the GitHub API during the release reconnaissance (`release/CURRENT_REL
70
  | Component | Repository | Visibility | Branch | Revision | Host |
71
  |---|---|---|---|---|---|
72
  | Frontend | `Anish-lab-blip/SatQuery-Frontend` | **private** | `main` | **`2d7ae53b482d`** | Cloudflare Pages β†’ `satquery.pages.dev` |
73
- | Backend / orchestrator | `Anish-lab-blip/SatQuery-Backend` | **private** | `main` | **`89d80eaddec5`** | Render β†’ `satquery-backend-m4yv.onrender.com` |
74
  | Inference | `Anish-lab-blip/SatQuery-Inference` | **private** | `main` | **`5a0936ace491`** | Codespace `potential-space-trout-r4ppw969w45j2pvvw`, port 8000 |
75
  | Public umbrella | `Anish-lab-blip/SatQuery-AI` | **public** | `main` | `3dcabd32da41` ("Initial commit") | this release home |
76
  | Monorepo (working copy) | `C:/Users/anish/satquery-ai` | local only | `master` | `9d57aed` | **no git remote**; 334 dirty entries |
@@ -108,7 +114,7 @@ Browser
108
  Cloudflare Pages β€” satquery.pages.dev (static frontend, 11 pages)
109
  β”‚ HTTPS / JSON β†’ /api/*
110
  β–Ό
111
- Render β€” satquery-backend-m4yv.onrender.com (orchestrator / gateway)
112
  β”‚ outbound long-poll POST /tunnel/agent
113
  β–Ό
114
  GitHub Codespace β€” FastAPI inference, CPU, port 8000
@@ -432,7 +438,7 @@ monorepo's stale blueprint.
432
  | `SATQUERY_MAX_FILE_BYTES` | per-file cap, shared with Render so the two layers cannot disagree |
433
  | `SATQUERY_ASSET_ENABLED` / `SATQUERY_ASSET_DIR` | both required for `/v1/assets`; **fails closed (503)** otherwise |
434
  | `SATQUERY_ASSET_MAX_FILES` / `SATQUERY_ASSET_TTL_S` | optional handle capacity / lifetime |
435
- | `SATQUERY_HUB_URL` | the Render orchestrator the tunnel agent dials out to; default `https://satquery-backend-m4yv.onrender.com` |
436
 
437
  Sources: `docs/DEPLOYMENT_TOPOLOGY.md` Β§3.3; `deploy/codespace/launch.sh`.
438
 
 
18
  > the monorepo's `deploy/render/main.py` is an earlier, tunnel-less revision. Edits must go to the
19
  > three real repositories, never to the local `deploy/` tree.
20
 
21
+ > **Hostnames are deliberately not published.** The orchestrator's public hostname appears throughout
22
+ > this release as `<backend-host>`. The deployment is documented for reproducibility β€” the topology,
23
+ > the environment-variable *names*, the timeout chain and the failure modes are all exact β€” without
24
+ > advertising the live endpoint. The three deployment repositories are private and are not part of
25
+ > this release.
26
+
27
  **Companions.** [`architecture/02-deployment-topology.md`](architecture/02-deployment-topology.md)
28
  (the long-form topology treatment), [`OPERATIONS.md`](OPERATIONS.md) (running the live system),
29
  [`SECURITY.md`](SECURITY.md) (the trust boundary),
 
76
  | Component | Repository | Visibility | Branch | Revision | Host |
77
  |---|---|---|---|---|---|
78
  | Frontend | `Anish-lab-blip/SatQuery-Frontend` | **private** | `main` | **`2d7ae53b482d`** | Cloudflare Pages β†’ `satquery.pages.dev` |
79
+ | Backend / orchestrator | `Anish-lab-blip/SatQuery-Backend` | **private** | `main` | **`89d80eaddec5`** | Render β†’ `<backend-host>` |
80
  | Inference | `Anish-lab-blip/SatQuery-Inference` | **private** | `main` | **`5a0936ace491`** | Codespace `potential-space-trout-r4ppw969w45j2pvvw`, port 8000 |
81
  | Public umbrella | `Anish-lab-blip/SatQuery-AI` | **public** | `main` | `3dcabd32da41` ("Initial commit") | this release home |
82
  | Monorepo (working copy) | `C:/Users/anish/satquery-ai` | local only | `master` | `9d57aed` | **no git remote**; 334 dirty entries |
 
114
  Cloudflare Pages β€” satquery.pages.dev (static frontend, 11 pages)
115
  β”‚ HTTPS / JSON β†’ /api/*
116
  β–Ό
117
+ Render β€” <backend-host> (orchestrator / gateway)
118
  β”‚ outbound long-poll POST /tunnel/agent
119
  β–Ό
120
  GitHub Codespace β€” FastAPI inference, CPU, port 8000
 
438
  | `SATQUERY_MAX_FILE_BYTES` | per-file cap, shared with Render so the two layers cannot disagree |
439
  | `SATQUERY_ASSET_ENABLED` / `SATQUERY_ASSET_DIR` | both required for `/v1/assets`; **fails closed (503)** otherwise |
440
  | `SATQUERY_ASSET_MAX_FILES` / `SATQUERY_ASSET_TTL_S` | optional handle capacity / lifetime |
441
+ | `SATQUERY_HUB_URL` | the Render orchestrator the tunnel agent dials out to; default `https://<backend-host>` |
442
 
443
  Sources: `docs/DEPLOYMENT_TOPOLOGY.md` Β§3.3; `deploy/codespace/launch.sh`.
444