Deployment & Environments
Operations Manual • Cloudflare Workers, DNS & Secrets Management
1. Cloudflare Environment & Account
All XTND Vantage edge infrastructure is provisioned under the centralized XTND DYNAMICS Cloudflare enterprise account:
- Cloudflare Account ID:
b4a9d6d55078009ff75dfac01f83fe80 - Primary Apex Domain:
xgi.io - Telemetry Subdomain Zone:
vantage.xgi.io
2. Deploying Edge Workers
Deployment of edge workers is handled via wrangler (v3.109+):
2.1 Central Vantage API (xtnd-vantage-api)
cd Workspaces/xtnd-vantage/xtnd-vantage-api
npm run prebuild # Generates version.generated.ts
npx wrangler deploy
- Custom Domain:
api.vantage.xgi.io - Bindings: KV (
VANTAGE_KV), Analytics Engine (VANTAGE_ANALYTICS)
2.2 Sonar AI Gateway (xtnd-sonar-api)
cd Workspaces/xtnd-vantage/xtnd-sonar-api
npx wrangler deploy
- Custom Domain:
api.sonar.vantage.xgi.io - Vars:
CENTRAL_VANTAGE_API = "https://api.vantage.xgi.io"
2.3 Radar Web Gateway (xtnd-radar-api)
cd Workspaces/xtnd-vantage/xtnd-radar-api
npx wrangler deploy
- Custom Domain:
api.radar.vantage.xgi.io - Vars:
CENTRAL_VANTAGE_API = "https://api.vantage.xgi.io"
3. Deploying the Web Front-Ends
Both front-ends are static-asset Cloudflare Workers. CI deploys each one on every push to main (.github/workflows/deploy.yml runs wrangler deploy); a manual deploy is only for emergencies.
3.1 Argus Dashboard (xtnd-argus-web)
cd Workspaces/xtnd-vantage/xtnd-argus-web
npm run build # stamps public/version.json
npx wrangler deploy
- Custom Domain:
argus.xgi.io
3.2 Vantage Portal & Documentation (xtnd-vantage-web)
Built from this repository: CI checks out xtnd-vantage-doc, renders every page, and deploys the result.
- Custom Domain:
vantage.xgi.io
A Worker's custom domains are managed by its
wrangler.jsonc. When the config lists any custom domain,wrangler deployreplaces the Worker's whole set and detaches every domain not listed.
4. DNS Routing Table
| Subdomain | Target Type | Destination Worker / Project |
|---|---|---|
api.vantage.xgi.io |
Custom Domain Route | xtnd-vantage-api |
api.sonar.vantage.xgi.io |
Custom Domain Route | xtnd-sonar-api |
api.radar.vantage.xgi.io |
Custom Domain Route | xtnd-radar-api |
argus.xgi.io |
Worker Custom Domain | xtnd-argus-web |
vantage.xgi.io |
Worker Custom Domain | xtnd-vantage-web |