Il-livell web fuq Vercel

Id-disinn jinsab f’docs/architecture/23-ops.md sezzjoni 5. Vercel imexxi l-livell web biss. Kull ma hemm ieħor jaħdem fuq host sieħeb li topera int, u mhuwiex fakultattiv.

Status f’din ir-release

Il-konfigurazzjoni tinsab f’postha (apps/web/vercel.json, il-preset Nitro vercel u l-kontrolli tal-bidu). Vercel jeħtieġ ħażna ta’ fajls kondiviża (QUIRE_STORAGE_DRIVER=s3 jew azure), driver realtime li jaħdem bejn istanzi tal-funzjonijiet (QUIRE_REALTIME_DRIVER=sse jew centrifugo) u fornitur tal-email HTTP. Mingħajrhom il-livell web jirrifjuta li jibda u l-log tiegħu jsemmi kull setting nieqes.

Il-biċċiet

Piece	Where it runs
`web`	Vercel Functions, runtime Node: paġni, REST, MCP, LTI, webhooks riċevuti
`worker`, `scheduler`, `collab`, `content`	Host sieħeb: Fly, Railway, ECS, jew il-host Docker tiegħek b’`docker/compose.yaml`
Postgres	Estern, wara pooler ta’ tranżazzjonijiet: Neon, Supabase, jew RDS b’PgBouncer
Files	S3 jew R2. M’hemm l-ebda disk persistenti
Background jobs	Ikkwodjati b’pg-boss ġewwa t-tranżazzjoni tat-talba, imħaddma mill-worker sieħeb. B’`QUIRE_QUEUE_DRIVER=vercel` fuq il-worker sieħeb, ix-xogħol ħafif (kunsinni ta’ notifiki mhux ordnati u webhook) jgħaddi minn Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), biex il-Postgres pooled ma jiġix polled għalihom
Recurring jobs	L-iskedar sieħeb. M’hemm l-ebda rotta Vercel Cron, għax cron li jagħmel xogħol ġewwa funzjoni jispiċċa
Tracing	OpenTelemetry lejn il-kollettur tiegħek, `OTEL_EXPORTER_OTLP_ENDPOINT`

X’dan il-mira ma jistax jagħmel

Il-livell web jiċċekkja dawn meta jibda u jirrifjuta, billi jsemmi kull problema, aktar milli jfalli aktar tard mal-ewwel email li qatt ma tintbagħat:

Ebda SMTP. Vercel jimblokka SMTP ħiereġ. Issettja QUIRE_EMAIL_PROVIDER_CONFIG għal fornitur HTTP (Postmark, SES, Mailgun, SendGrid jew Resend). QUIRE_SMTP_URL huwa rifjutat.
Ebda disk lokali. QUIRE_STORAGE_DRIVER=local huwa rifjutat.
Ebda memorja kondiviża bejn invokazzjonijiet. QUIRE_REALTIME_DRIVER=inprocess huwa rifjutat. Avvenimenti mibgħuta mis-server huma limitati għat-timeout tal-funzjoni; il- klijent jerġa’ jikkonnettja b’cursor, biex l-ebda avveniment ma jintilef, iżda l-preżenza hija mhux disponibbli.
Databases tal-tenant imwaħħla huma limitati għal madwar tmienja, għax kull waħda hija pool ta’ konnessjonijiet ieħor f’ambjent li ma jistax jaqsam pools.

Deployjar

Oħloq proġett Vercel mir-repożitorju b’Root Directory apps/web. apps/web/vercel.json jissettja l-kmandi tal-installazzjoni u tal-build (NITRO_PRESET=vercel) u jservi /sw.js mhux cached.
Issettja l-varjabbli tal-ambjent. Minn docker/.env.example, mill-inqas: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (l-indirizz tal-pooler), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, is-settings tal-ħażna, u QUIRE_COLLAB_URL u QUIRE_COLLAB_SIGNING_KEY li jindikaw lejn is- servizz collab tas-sieħeb. QUIRE_REPORT_DATABASE_URL huwa tad-database fiżika msemmija minn DATABASE_URL. Għal kull database reġistrata addizzjonali, żid il-URL tal-konnessjoni quire_report tagħha stess mal-ambjenti kemm tal-web kif ukoll tal-worker, imbagħad irreġistra l-isem tal-varjabbli tal-ambjent tagħha bħala env:NAME fil-console tal-pjattaforma. L-analitika tfalli magħluqa jekk il-URL tar-rapport ta’ dik id-database ikun nieqes.
Fuq il-host sieħeb, ħaddem docker/compose.yaml mingħajr is-servizz web, bl-istess docker/.env:
```
docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
```
Il-migrazzjonijiet jaħdmu hemmhekk, qabel ma kull deployment ta’ Vercel jiġi promoss.
Deployja. Fuq konfigurazzjoni rifjutata l-log tal-funzjoni jibda b’“The web tier did not start on vercel” u jelenka kull setting x’tibdel.

Aġġornament

Emigra mill-host sieħeb l-ewwel, imbagħad ippromwovi d-deployment il-ġdid ta’ Vercel, imbagħad dawwar il-workers tas-sieħeb: l-ordni f’ upgrade.md. Rollback istantanju ta’ Vercel huwa rollback tal-kodiċi u huwa dejjem sigur f’release.