defiQUGandCursor
86646c6f3c
Move legacy deployment guides to docs/archive/azure-deprecated/, replace auto GitHub Pages with artifact upload plus optional pages-preview workflow, update architecture diagram and doc index, and ignore Lighthouse temp artifacts. Co-authored-by: Cursor <[email protected]>
58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
# Deployment prerequisites (Proxmox production)
|
|
|
|
> **Azure removed (2026-06):** Static Web Apps, Bicep infra, Azure Functions (`api/`), and Azure CI workflows are no longer part of this repo. Production is **VMID 7810** via Proxmox — see [PROXMOX_DEPLOYMENT.md](./deployment/PROXMOX_DEPLOYMENT.md).
|
|
|
|
## 1. Operator / LAN access
|
|
|
|
| Requirement | Detail |
|
|
|-------------|--------|
|
|
| Proxmox SSH | `[email protected]` (r630-02) |
|
|
| Web CT | VMID **7810** @ `192.168.11.37` |
|
|
| API CT | VMID **7811** @ `192.168.11.36` (optional; `/api/` proxy) |
|
|
| Deploy script | `../proxmox/scripts/mim4u-deploy-to-7810.sh` |
|
|
|
|
## 2. Build toolchain
|
|
|
|
```bash
|
|
node -v # 22.x recommended
|
|
npm -v # 10+
|
|
convert -version # ImageMagick (brand prebuild)
|
|
```
|
|
|
|
Install deps:
|
|
|
|
```bash
|
|
cd miracles_in_motion
|
|
npm ci # uses legacy-peer-deps via .npmrc
|
|
```
|
|
|
|
## 3. Environment variables
|
|
|
|
Copy `.env.example` → `.env.local` for local dev. Production frontend is static; secrets belong on **7811** (API) or NPMplus, not in the Vite bundle.
|
|
|
|
| Variable | Purpose |
|
|
|----------|---------|
|
|
| `VITE_STRIPE_PUBLISHABLE_KEY` | Donate page (public key only) |
|
|
| `VITE_API_BASE_URL` | Override API base (default `/api` via nginx) |
|
|
| `VITE_GA_MEASUREMENT_ID` | Analytics (optional) |
|
|
|
|
See `env.production.example` for a non-Azure production template.
|
|
|
|
## 4. Pre-deploy checklist
|
|
|
|
- [ ] `npm run validate:ci` passes (type-check + tests + header WCAG audit)
|
|
- [ ] `npm run build` succeeds (brand export + Vite)
|
|
- [ ] NPMplus TLS valid for mim4u.org / www / secure / training
|
|
- [ ] `./scripts/mim4u-deploy-to-7810.sh` from proxmox repo (or `--dry-run` review)
|
|
- [ ] Post-deploy: `curl -H 'Host: mim4u.org' http://192.168.11.37/` → 200
|
|
- [ ] Optional: `npm run a11y:header-audit:live` on production URL
|
|
|
|
## 5. Stripe & DNS (unchanged)
|
|
|
|
- **Stripe:** live keys and webhooks configured on API (7811), not in this static repo.
|
|
- **Cloudflare / DNS:** A/AAAA or CNAME to public IP per NPMplus; use proxmox `scripts/update-all-dns-to-public-ip.sh --zone-only=mim4u.org --dry-run` before changes.
|
|
|
|
## 6. Legacy documentation
|
|
|
|
Azure deployment guides were **archived** to `docs/archive/azure-deprecated/` (2026-06). Do not follow them for new deploys.
|