Documentation

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 deploy replaces 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