Cloudflare Workers ގައި web tier

ކުޑަވެފައިވާ ޤުއަރޭ web tier އެއް Cloudflare Workers ގައި ހިންގާށެވެ.

މިޒައިން docs/architecture/23-ops.md ގެ 6 ވަނަ ސެކްޝަނެވެ. Workers އިން ކުޑަވެފައިވާ web tier އެއް ހިންގައެވެ. Workers ގައި feature parity އަކީ scope ނޫނެވެ (PRD ގެ 12 ވަނަ section): މި target އަކުން ނުކުރެވޭ ތަކެއްޗެއް ހިންގާއިރު ނަން ދައްކައި ރިޖެކްޓްކުރެވެއެވެ.

މި release ގެ ޙާލަތު

ކޮންފިގަރޭޝަން ހުރެއެވެ (apps/web/wrangler.jsonc، cloudflare-module Nitro preset، Hyperdrive bridge އަދި startup checks). Worker އަށް R2 އަށް S3-compatible storage (QUIRE_STORAGE_DRIVER=s3)، request ތަކާ ދެމެދު realtime driver (QUIRE_REALTIME_DRIVER=durable_objects ނުވަތަ centrifugo)، shared cache (QUIRE_CACHE_DRIVER=postgres ނުވަތަ valkey) އަދި HTTP email provider ލާޒިމެވެ. މިއެއް ނެތްނަމަ Worker ހިންގާނެއް ނޫނެވެ، log ގައި ސެޓިންގްތައް ނަންދެއެވެ. Durable Objects driver އަކީ apps/realtime-worker ގެ realtime Worker ގެ client އެކެވެ (fan-out، presence އަދި history އަށް channel އަކަށް އެއް Durable Object، disconnect އަށް މީހަކަށް އެއް); ތިރީގައި އެއާއެކު deploy ކުރާ، ނުވަތަ Centrifugo ބޭނުންކުރާށެވެ.

ބައިތައް

ބައި	Cloudflare ގައި
`web`	`nodejs_compat` އާއެކު Worker
Postgres	Hyperdrive މެދުވެރިކޮށް external: application role އަށް `HYPERDRIVE`، އެ physical database ގެ report role އަށް `REPORT_HYPERDRIVE`. ހިންގާއިރު web tier ކޮންމެ connection string އެއް `DATABASE_URL` އަދި `QUIRE_REPORT_DATABASE_URL` އަށް ކޮޕީކުރެއެވެ
Files	R2، S3 API އިން (`S3_ENDPOINT=https://<account>.r2.cloudflarestorage.com`); `FILES` binding އިން bucket ގުޅުވައެވެ
Background jobs	write އާއިއެކު enqueue ކުރަންޖެހޭނަމަ Hyperdrive މަތިން pg-boss. Companion worker ގައި `QUIRE_QUEUE_DRIVER=cloudflare` ހުރިޔާ ލުއި job (unordered notification އަދި webhook delivery) Cloudflare Queues އިން ދާނެއެވެ؛ Postgres އަށް poll ނުކުރާނެއެވެ. Companion worker ދެމެދު ދެތިން ހިންގައެވެ
Realtime	Durable Objects އާއެކު realtime Worker، `apps/realtime-worker`
`worker`، `scheduler`، `collab`، `content`، ClamAV، Gotenberg، ffmpeg	Companion container host. Worker އިން މިތަކެއް ނުހިންގާނެއެވެ
Tracing	Workers observability؛ `wrangler.jsonc` ގައި enable ކުރާށެވެ

REPORT_HYPERDRIVE އިން HYPERDRIVE ނަންދޭ physical database ގެ report role ދެއެވެ. ތިރީގައި އެންގި ގޮތަށް މި target އިން additional physical database ތަކަށް pinned tenant ނުހިންގާނެއެވެ.

މި target އަކުން ނުކުރެވޭ ތަކެތި

ހިންގުމުގައި ހުރިހާ މައްސަލަ ލިސްޓްކޮށް ރިޖެކްޓްކުރެއެވެ:

SMTP ނެތެވެ. QUIRE_EMAIL_PROVIDER_CONFIG ގައި HTTP provider އެއް ބޭނުންކުރާށެވެ.
Local disk ނެތެވެ. QUIRE_STORAGE_DRIVER އިން object storage ނަން ދޭންޖެހެއެވެ.
In-process realtime ނުވަތަ cache ނެތެވެ. Worker request ތަކާ ދެމެދު memory ނުޝެއާރކުރެއެވެ، އެހެންވެ QUIRE_REALTIME_DRIVER=inprocess އަދި QUIRE_CACHE_DRIVER=memory މަނާވެއެވެ.
Worker ގައި ClamAV، Gotenberg ނުވަތަ ffmpeg ނެތެވެ. CLAMAV_URL، GOTENBERG_URL އަދި FFMPEG_PATH Worker ގައި ސެޓްކުރިޔާ ރިޖެކްޓްވާނެއެވެ؛ އޭތައް companion worker ގައި ސެޓްކުރާށެވެ.
Dedicated database ހުރި އޮގަނައިޒޭޝަން ނެތެވެ. Worker ގެ Hyperdrive binding ތައް deploy ވަގުތު ނިންމެވެއެވެ؛ އަމިއްލަ database ހުރި އޮގަނައިޒޭޝަނަށް “މިތަނުގައި ނުލިބޭ” ޕޭޖެއް ދެއެވެ. Compose ނުވަތަ Vercel އިން އެއީ ހިންގާށެވެ.

އަދި އެނގިގެންވާ އެއްކަމެއް: prerender އަދި incremental static regeneration Workers ގައި ނުހިންގާނެއެވެ، framework documentation ގައި ކީ ބުނިޔަސް. ކޮންމެ route އެއްވެސް request އަކަށް render ވެއެވެ.

މި target ގައި transaction ތައް ކުރުކޮށް، network call އާއެކު އެއްވެސް transaction ނުބެހެއްޓާށެވެ: Hyperdrive connection އެއް pool އަށް އަނބުރާލާއިރު session state reset ކުރެއެވެ، އެހެންވެ tenant context transaction އަކަށް set ކުރަންޖެހެއެވެ.

Deploy ކުރުން

Resources ހަދާށެވެ:

bun run --bun wrangler hyperdrive create quire-app --connection-string="postgres://quire_app:...@db.example.com:5432/quire"
bun run --bun wrangler hyperdrive create quire-report --connection-string="postgres://quire_report:...@db.example.com:5432/quire"
bun run --bun wrangler r2 bucket create quire-files
bun run --bun wrangler queues create quire-jobs

ދެ Hyperdrive ID ތައް apps/web/wrangler.jsonc ގައި ލާށެވެ.

Secret ތައް ކޮންމެ އެއް bun run --bun wrangler secret put <NAME> އިން ސެޓްކޮށް، apps/web އިން ހިންގައި، މިތަކެއްޗެއް ލާށެވެ: QUIRE_SECRET_KEY، QUIRE_MASTER_KEY، QUIRE_EMAIL_PROVIDER_CONFIG، S3_ACCESS_KEY_ID، S3_SECRET_ACCESS_KEY، QUIRE_COLLAB_SIGNING_KEY، QUIRE_REALTIME_WORKER_SECRET. އާންމު settings (QUIRE_APP_ORIGIN، QUIRE_CONTENT_ORIGIN، QUIRE_PLATFORM_DOMAINS، QUIRE_DATABASE_ID، S3_ENDPOINT، S3_BUCKET، QUIRE_COLLAB_URL) vars ގައި ލާށެވެ.

apps/web އިން build ކޮށް deploy ކުރާށެވެ:

NITRO_PRESET=cloudflare-module bun run build
bun run --bun wrangler deploy

Realtime Worker ވެސް web tier ގެ QUIRE_REALTIME_WORKER_SECRET އާއި token secret QUIRE_REALTIME_TOKEN_SECRET އާއެކު deploy ކުރާށެވެ (web tier އިން realtime token ތައް އޭގެ QUIRE_REALTIME_TOKEN_SECRET އިން ސޮއިކުރެއެވެ؛ އެއީ ނެތްނަމަ QUIRE_SECRET_KEY އިން. އެއްބޭނުންކުރާށެވެ)، އަދި web tier ގައި QUIRE_REALTIME_WORKER_URL އެއަށް ދާ address ސެޓްކުރާށެވެ:
```
cd apps/realtime-worker
bun run --bun wrangler secret put QUIRE_REALTIME_WORKER_SECRET
bun run --bun wrangler secret put QUIRE_REALTIME_TOKEN_SECRET
bun run --bun wrangler deploy
```
ލުއި job އަށް Cloudflare Queues ބޭނުންކުރާނަމަ ކޮންމެ light queue އަކަށް އެއް queue ހަދައި، companion worker ގައި މިތަކެއްޗެއް ސެޓްކުރާށެވެ (Queues read އަދި write އިޚްތިޞާޞްހުރި API token):
```
bun run --bun wrangler queues create quire-events-notifications
bun run --bun wrangler queues create quire-events-notifications-dead
bun run --bun wrangler queues create quire-events-webhooks
bun run --bun wrangler queues create quire-events-webhooks-dead
```
QUIRE_QUEUE_DRIVER=cloudflare، CLOUDFLARE_ACCOUNT_ID، CLOUDFLARE_QUEUES_TOKEN އަދި QUIRE_QUEUE_PREFIX ނޫންނަމަ quire- ސެޓްކުރާށެވެ.
Vercel guide ގެ 3 ވަނަ step ފަދައިން companion host ހިންގާށެވެ. Worker deploy ކޮންމެއްގެ ކުރިން migrations އެތާ ހިންގާނެއެވެ.

ރިޖެކްޓްވި config އެއް bun run --bun wrangler tail ގައި “The web tier did not start on cloudflare” ކަމަށް ދައްކާ، ބަދަލުކުރަންޖެހޭ ސެޓިންގްތައް ލިސްޓްކުރެއެވެ.