70 lines
4.0 KiB
Markdown
70 lines
4.0 KiB
Markdown
# Cloudflare Pages & Workers Setup — Linear Void
|
|
|
|
Linear Void uses two Cloudflare products:
|
|
|
|
| Product | Purpose | What |
|
|
| ----------- | ------------------ | ------------------------------------------------------------------------------------ |
|
|
| **Pages** | Static SPA hosting | Vite-built frontend (`frontend/dist`) deployed via Git integration or Direct Upload |
|
|
| **Workers** | Edge cache logic | `infrastructure/cloudflare/worker.js` — adds immutable cache headers to HLS segments |
|
|
|
|
Both are managed under **Workers & Pages** in the Cloudflare dashboard.
|
|
|
|
## Dashboard URLs
|
|
|
|
| Resource | URL |
|
|
| ------------------------ | ------------------------------------------------------------------------------------------------------------------- |
|
|
| Workers & Pages overview | `https://dash.cloudflare.com/deb11491c54ec53a24772e98ac6d8128/workers-and-pages` |
|
|
| Worker: linearvoid | `https://dash.cloudflare.com/deb11491c54ec53a24772e98ac6d8128/workers/services/view/linearvoid/production/settings` |
|
|
| Pages project | `https://dash.cloudflare.com/deb11491c54ec53a24772e98ac6d8128/pages/view/linearvoid` |
|
|
| API tokens | <https://dash.cloudflare.com/profile/api-tokens> |
|
|
|
|
## Worker: `linearvoid` (edge cache headers)
|
|
|
|
The Worker at `infrastructure/cloudflare/worker.js` runs on the `linearvoid` Workers service. It intercepts requests and adds immutable `Cache-Control` headers to `.m4s` segment files.
|
|
|
|
Deploy via Wrangler CLI:
|
|
|
|
```bash
|
|
npx wrangler deploy infrastructure/cloudflare/worker.js
|
|
```
|
|
|
|
Or paste into the Workers dashboard at the URL above (Quick Edit).
|
|
|
|
## Pages: Static frontend
|
|
|
|
### Direct Upload via Gitea Actions
|
|
|
|
Use `.gitea/workflows/pages-deploy.yml` to build in Gitea Actions and upload via the Cloudflare API.
|
|
|
|
See [gitea-cloudflare-pages.md](./gitea-cloudflare-pages.md) for the workflow.
|
|
|
|
### Variables and secrets
|
|
|
|
On Cloudflare pages, set the following environment variables (needed to run the frontend)
|
|
|
|
| Type | Name | Value |
|
|
| --------- | -------------------------------------- | ----------------------------------------------- |
|
|
| Secret | ADMIN_PASSWORD | `not-a-real-admin-password` |
|
|
| Plaintext | ADMIN_SESSION_TTL_HOURS | `12` |
|
|
| Plaintext | ADMIN_USERNAME | `boogers` |
|
|
| Plaintext | HLS_SEGMENT_DURATION | `6` |
|
|
| Plaintext | HLS_WINDOW_SIZE | `24` |
|
|
| Plaintext | PLAYLIST_PATH | `/app/playlist/playlist.txt` |
|
|
| Plaintext | VITE_PUBLIC_ADMIN_DEFAULT_MODERATOR | `boogers` |
|
|
| Plaintext | VITE_PUBLIC_ADMIN_DEFAULT_ROOM | `main` |
|
|
| Plaintext | VITE_PUBLIC_ADMIN_MODERATION_LOG_LIMIT | `50` |
|
|
| Plaintext | VITE_PUBLIC_APP_URL | `https://linearvoid.tv` |
|
|
| Plaintext | VITE_PUBLIC_HLS_URL | `https://media.linearvoid.tv/hls/playlist.m3u8` |
|
|
| Plaintext | VITE_PUBLIC_WS_URL | `wss://linearvoid.tv/ws` |
|
|
|
|
## Custom domains
|
|
|
|
- `linearvoid.tv` → Pages project
|
|
- `www.linearvoid.tv` → redirect to `linearvoid.tv`
|
|
- `media.linearvoid.tv` → R2 bucket (separate; not Pages)
|
|
|
|
## Related
|
|
|
|
- [Gitea to Cloudflare Pages deployment guide](./gitea-cloudflare-pages.md)
|
|
- [Cloudflare & UptimeRobot checklist](./cloudflare-uptimerobot-checklist.md)
|