Ọkwa weebụ na Vercel

Nhazi ahụ dị na docs/architecture/23-ops.md ngalaba 5. Vercel na-agba naanị ọkwa weebụ. Ihe ọ bụla ọzọ na-agba na họst ibe ị na-elekọta, ọ dịghịkwa nhọrọ ịhapụ ya.

Ọnọdụ na mwepụta a

Nhazi ahụ adịlarị (apps/web/vercel.json, nhazi Nitro vercel na nlele mmalite). Vercel chọrọ usoro nchekwa faịlụ ọnụ (QUIRE_STORAGE_DRIVER=s3 ma ọ bụ azure), usoro ozi ozugbo na-arụ ọrụ gafee function dị iche iche (QUIRE_REALTIME_DRIVER=sse ma ọ bụ centrifugo) na onye na-enye email site na HTTP. Na-enweghị ha ọkwa weebụ jụrụ ịmalite, ndekọ ya akpọkwa ntọala ọ bụla na-efu.

Akụkụ dị iche iche

Akụkụ	Ebe ọ na-agba
`web`	Vercel Functions, Bun runtime: peeji, REST, MCP, LTI, webhook anatara
`worker`, `scheduler`, `collab`, `content`	Họst ibe: Fly, Railway, ECS, ma ọ bụ họst Docker nke gị na `docker/compose.yaml`
Postgres	N’èzí, n’azụ ọdọ mmiri transaction: Neon, Supabase, ma ọ bụ RDS na PgBouncer
Faịlụ	S3 ma ọ bụ R2. Enweghị disk na-adịgide
Ọrụ ndabere	A na-etinye ha n’ahịrị site na pg-boss n’ime transaction arịrịọ ahụ, worker ibe na-agba ha. Na `QUIRE_QUEUE_DRIVER=vercel` na worker ibe, ọrụ dị mfe (nnyefe ngosi na webhook na-enweghị usoro) na-aga site na Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), ka a ghara ịjụ Postgres ọdọ mmiri ajụjụ maka ha
Ọrụ na-eme ugboro ugboro	Onye nhazi oge ibe. Enweghị ụzọ Vercel Cron, n’ihi na cron na-arụ ọrụ n’ime function na-agwụ oge
Nsochi	OpenTelemetry gaa na onye nchịkọta gị, `OTEL_EXPORTER_OTLP_ENDPOINT`

Ihe ebumnobi a enweghị ike ime

Ọkwa weebụ na-enyocha ihe ndị a mgbe ọ malitere wee jụ, na-akpọ nsogbu ọ bụla, kama ịda ma e mesịrị na email mbụ na-ezigaghị:

Enweghị SMTP. Vercel na-egbochi SMTP na-apụ apụ. Tọọ QUIRE_EMAIL_PROVIDER_CONFIG na onye na-enye ọrụ site na HTTP (Postmark, SES, Mailgun, SendGrid ma ọ bụ Resend). A jụrụ QUIRE_SMTP_URL.
Enweghị disk mpaghara. A jụrụ QUIRE_STORAGE_DRIVER=local.
Enweghị ncheta ọnụ n’etiti oku. A jụrụ QUIRE_REALTIME_DRIVER=inprocess. A na-akwụsị ihe omume sava zitere na oge function; onye ahịa na-ejikọta ọzọ na cursor, ka ihe omume ọ bụla ghara ịla n’iyi, mana ọnụnọ adịghị.
A na-akwụsị nchekwa data tenant a tụkwasịrị ihe dị ka asatọ, n’ihi na nke ọ bụla bụ ọdọ mmiri njikọ ọzọ na gburugburu na-enweghị ike ịkekọrịta ọdọ mmiri.

Mbunye

Mepụta ọrụ Vercel site na ebe nchekwa na Root Directory apps/web. apps/web/vercel.json na-atọ iwu wụnye na wuo (NITRO_PRESET=vercel) ma na-enye /sw.js na-enweghị cache.
Tọọ mgbanwe gburugburu. Site na docker/.env.example, ọ dịkarịa ala: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (adreesị ọdọ mmiri), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, ntọala nchekwa, na QUIRE_COLLAB_URL na QUIRE_COLLAB_SIGNING_KEY na-atụ aka na ọrụ collab ibe. QUIRE_REPORT_DATABASE_URL bụ nke nchekwa data anụ ahụ DATABASE_URL kpọrọ. Maka nchekwa data ọ bụla ọzọ edebanyere aha, tinye URL njikọ quire_report nke ya na gburugburu weebụ na worker abụọ, debanyekwa aha mgbanwe gburugburu ya dịka env:NAME na console platform. Analytics na-emechi emechi ma URL akụkọ nchekwa data ahụ efu.
Na họst ibe, gbaa docker/compose.yaml na-enweghị ọrụ web, na otu docker/.env:
```
docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
```
Mbugharị na-agba ebe ahụ, tupu e kwalite mbunye Vercel ọ bụla.
Bunye. Na nhazi a jụrụ, ndekọ function na-amalite na “The web tier did not start on vercel” wee depụta ntọala ọ bụla ịgbanwe.

Mmelite

Bugharịa site na họst ibe nke mbụ, kwalitekwa mbunye Vercel ọhụrụ, gbanweekwa workers ibe: usoro dị na upgrade.md. Ịlaghachi Vercel ozugbo bụ ịlaghachi koodu, ọ dịkwa mma mgbe niile n’ime mwepụta.