Tá an dearadh in alt 5 de docs/architecture/23-ops.md. Ní ritheann Vercel ach an tsraith ghréasáin. Ritheann gach rud eile ar óstach compánach a oibríonn tú, agus níl sé roghnach.
Stádas san eisiúint seo
Tá an chumraíocht curtha i bhfeidhm (apps/web/vercel.json, réamhshocrú Nitro vercel agus seiceálacha tosaithe). Teastaíonn stóráil comhad chomhroinnte ó Vercel (QUIRE_STORAGE_DRIVER=s3 nó azure), tiománaí fíor-ama a oibríonn trasna cásanna feidhme (QUIRE_REALTIME_DRIVER=sse nó centrifugo), agus soláthraí ríomhphoist HTTP. Gan iad, diúltaíonn an tsraith ghréasáin tosú agus ainmníonn a log gach socrú atá ar iarraidh.
Na comhpháirteanna
Comhpháirt
Áit a ritheann sí
web
Vercel Functions, rite-ama Node: leathanaigh, REST, MCP, LTI agus webhooks a fhaightear
worker, scheduler, collab, content
Óstach compánach: Fly, Railway, ECS nó d’óstach Docker féin le docker/compose.yaml
Postgres
Seachtrach, taobh thiar de chomhthiomsaitheoir idirbheart: Neon, Supabase nó RDS le PgBouncer
Comhaid
S3 nó R2. Níl diosca leanúnach ann
Jabanna cúlra
Cuirtear sa scuaine pg-boss iad san idirbheart iarratais agus ritheann an próiseálaí compánach iad. Le QUIRE_QUEUE_DRIVER=vercel ar an bpróiseálaí compánach, téann jabanna éadroma (seachadtaí fógraí agus webhook nach bhfuil ordaithe) trí Vercel Queues (VERCEL_QUEUE_REGION, VERCEL_QUEUE_TOKEN), ionas nach ndéantar vótáil orthu sa Postgres comhthiomsaithe
Jabanna athfhillteacha
Sceidealóir an óstaigh chompánaigh. Níl bealach Vercel Cron ann, mar théann cron a dhéanann obair taobh istigh d’fheidhm thar am istigh
Rianú
OpenTelemetry chuig do bhailitheoir, OTEL_EXPORTER_OTLP_ENDPOINT
Rudaí nach féidir leis an sprioc seo a dhéanamh
Seiceálann an tsraith ghréasáin iad seo ar an tosú agus diúltaíonn sí, agus ainmníonn sí gach fadhb, in áit teip níos déanaí nuair nach seoltar an chéad ríomhphost:
Níl SMTP ar fáil. Cuireann Vercel bac ar SMTP amach. Socraigh QUIRE_EMAIL_PROVIDER_CONFIG ar sholáthraí HTTP (Postmark, SES, Mailgun, SendGrid nó Resend). Diúltaítear do QUIRE_SMTP_URL.
Níl diosca áitiúil ar fáil. Diúltaítear do QUIRE_STORAGE_DRIVER=local.
Níl cuimhne chomhroinnte idir glaonna. Diúltaítear do QUIRE_REALTIME_DRIVER=inprocess. Tá sruthanna seolta imeachtaí teoranta d’am feidhme; athcheanglaíonn an cliant le cúrsóir, mar sin ní chailltear imeacht, ach níl láithreacht ar fáil.
Tá líon na mbunachar sonraí tionónta pionnáilte teoranta do thart ar ocht gcinn, mar gurb ionann gach ceann breise agus comhthiomsú ceangail eile i dtimpeallacht nach féidir leo comhthiomsuithe a roinnt.
Imscaradh
Cruthaigh tionscadal Vercel ón stór leis an Root Directory socraithe mar apps/web. Socraíonn apps/web/vercel.json orduithe suiteála agus tógála (NITRO_PRESET=vercel) agus freastalaíonn sé ar /sw.js gan taisce.
Socraigh athróga timpeallachta. Ó docker/.env.example, teastaíonn ar a laghad: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (seoladh an chomhthiomsaitheora), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, socruithe stórála, agus QUIRE_COLLAB_URL agus QUIRE_COLLAB_SIGNING_KEY dírithe ar sheirbhís collab an óstaigh chompánaigh.
Baineann QUIRE_REPORT_DATABASE_URL leis an mbunachar sonraí fisiciúil atá ainmnithe ag DATABASE_URL. I gcás gach bunachair chláraithe bhreise, cuir a URL ceangail quire_report féin le timpeallachtaí web agus worker, ansin cláraigh ainm a athróige timpeallachta mar env:NAME i gconsól an ardáin. Teipeann anailísíocht dúnta mura bhfuil URL tuairiscithe an bhunachair sin ann.
Ar an óstach compánach, rith docker/compose.yaml gan an tseirbhís web, agus úsáid an docker/.env céanna:
Ritheann aistrithe ansin, sula gcuirtear gach imscaradh Vercel chun cinn.
Déan imscaradh. Má dhiúltaítear don chumraíocht, tosaíonn log na feidhme le “The web tier did not start on vercel” agus liostaíonn sé gach socrú atá le hathrú.
Uasghrádú
Rith aistriú ón óstach compánach ar dtús, ansin cuir imscaradh nua Vercel chun cinn, agus ar deireadh rollaigh próiseálaithe an chompánaigh: seo an t-ord in upgrade.md. Is filleadh ar chód é filleadh láithreach Vercel agus bíonn sé sábháilte i gcónaí laistigh d’eisiúint.
Quire