Vefþrepið á Vercel

Hönnunin er í docs/architecture/23-ops.md kafla 5. Vercel keyrir aðeins vefþrepið. Allt annað keyrir á fylgdarhýsil sem þú rekur, og hann er ekki valkvæmur.

Staðan í þessari útgáfu

Uppsetningin er til staðar (apps/web/vercel.json, vercel Nitro- forstillingin og ræsingarathuganirnar). Vercel þarf sameiginlega skráageymslu (QUIRE_STORAGE_DRIVER=s3 eða azure), rauntímarekil sem virkar þvert á tilvik falla (QUIRE_REALTIME_DRIVER=sse eða centrifugo) og tölvupóstveitu yfir HTTP. Án þeirra neitar vefþrepið að ræsa og annállinn nefnir hverja vantarandi stillingu.

Hlutarnir

Hlutur	Hvar hann keyrir
`web`	Vercel Functions, Node-keyrslutími: síður, REST, MCP, LTI, mótteknir vefkrókar
`worker`, `scheduler`, `collab`, `content`	Fylgdarhýsill: Fly, Railway, ECS eða eigin Docker-hýsill með `docker/compose.yaml`
Postgres	Ytri, bak við viðskiptapúllara: Neon, Supabase eða RDS með PgBouncer
Skrár	S3 eða R2. Enginn varanlegur diskur er til staðar
Bakgrunnsverk	Sett í biðröð með pg-boss innan viðskipta beiðninnar, keyrð af fylgdarvinnsluvélinni. Með `QUIRE_QUEUE_DRIVER=vercel` á fylgdarvinnsluvélinni fara léttu verkin (óraðaðar tilkynningar og vefkrókasendingar) í gegnum Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), svo púlerað Postgres er ekki kannað fyrir þau
Endurtekin verk	Fylgdarstýringin. Engin Vercel Cron-leið er til, því cron sem vinnur inni í falli rennur út á tíma
Rekjanleiki	OpenTelemetry til söfnunartækis þíns, `OTEL_EXPORTER_OTLP_ENDPOINT`

Hvað þetta markumhverfi getur ekki

Vefþrepið athugar þetta þegar það ræsir og neitar, og nefnir hvert vandamál, frekar en að bila síðar við fyrsta tölvupóstinn sem kemst aldrei á leiðarenda:

Enginn SMTP. Vercel lokar á SMTP útfara. Stilltu QUIRE_EMAIL_PROVIDER_CONFIG á HTTP-veitu (Postmark, SES, Mailgun, SendGrid eða Resend). QUIRE_SMTP_URL er hafnað.
Enginn staðbundinn diskur. QUIRE_STORAGE_DRIVER=local er hafnað.
Ekkert sameiginlegt minni milli kalla. QUIRE_REALTIME_DRIVER=inprocess er hafnað. Atburðir sendir af þjóni eru takmarkaðir við tímamörk fallsins; biðlarinn tengist aftur með bendli, svo enginn atburður tapast, en viðvera er ekki í boði.
Föst leigjendagagnagrunna eru takmarkaðir við um átta, því hver þeirra er enn einn tengingapúllarinn í umhverfi sem getur ekki deilt púllurum.

Uppsetning

Stofnaðu Vercel-verkefni úr geymslunni með Root Directory apps/web. apps/web/vercel.json stillir uppsetningar- og byggingarskipanirnar (NITRO_PRESET=vercel) og sendir /sw.js án skyndiminningar.
Stilltu umhverfisbreyturnar. Frá docker/.env.example, að minnsta kosti: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (fang púllarans), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, geymslustillingarnar, og QUIRE_COLLAB_URL og QUIRE_COLLAB_SIGNING_KEY sem benda á samvinnuþjónustu fylgdarhýsilsins. QUIRE_REPORT_DATABASE_URL tilheyrir líkamlega gagnagrunninum sem DATABASE_URL nefnir. Fyrir hvern viðbótarskráðan gagnagrunn skaltu bæta hans eigin quire_report tengislóð við bæði vef- og vinnsluumhverfið og skráðu síðan nafn umhverfisbreytunnar sem env:NAME í stjórnborði vettvangsins. Greining bilar lokuð ef skýrsluslóð þess gagnagrunns vantar.
Á fylgdarhýslnum skaltu keyra docker/compose.yaml án web þjónustunnar, með sömu docker/.env:
```
docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
```
Flutningar keyra þar, áður en hverri Vercel-útgáfu er hleypt út.
Settu út. Við hafnaðri uppsetningu byrjar annáll fallsins á „The web tier did not start on vercel“ og telur upp hverja stillingu til að breyta.

Uppfærsla

Flyttu fyrst frá fylgdarhýslnum, hleypdu síðan út nýju Vercel- útgáfunni og veltu síðan vinnsluvélum fylgdarhýsilsins: röðin í upgrade.md. Augnabliksbakfærsla Vercel er bakfærsla kóða og er alltaf örugg innan útgáfu.