Leum dhan t-susbaint

An t-sreath-lìn air Vercel

Ruith an t-sreath-lìn Quire air Vercel le pròiseas-obrach companach.

Seall mar Markdown

Tha an dealbhadh aig earrann 5 de docs/architecture/23-ops.md. Chan eil Vercel a’ ruith ach an t-sreath-lìn. Tha a h-uile càil eile air aoigh companach a tha thu ag obrachadh, agus tha sin riatanach.

Inbhe san tionndadh seo

Tha an rèiteachadh deiseil (apps/web/vercel.json, ro-shuidheachadh Nitro vercel agus na sgrùdaidhean tòiseachaidh). Feumaidh Vercel stòradh fhaidhlichean co-roinnte (QUIRE_STORAGE_DRIVER=s3 no azure), draibhear fìor-ùine a dh’obraicheas thar eisimpleirean ghnìomhan (QUIRE_REALTIME_DRIVER=sse no centrifugo) agus solaraiche post-d HTTP. Mura h-eil iad ann, diùltas an t-sreath-lìn tòiseachadh agus ainmichidh an log gach roghainn a tha a dhìth.

Na pìosan

Pìos Càit an ruith e
web Vercel Functions, àm-ruith Node: duilleagan, REST, MCP, LTI, webhooks a gheibhear
worker, scheduler, collab, content Aoigh companach: Fly, Railway, ECS no aoigh Docker agad fhèin le docker/compose.yaml
Postgres Taobh a-muigh, air cùl cruinniche ghnothaichean: Neon, Supabase no RDS le PgBouncer
Faidhlichean S3 no R2. Chan eil diosg mhaireannach ann
Obraichean cùl-raoin Air an cur sa chiudha le pg-boss am broinn gnothach an iarrtais agus air an ruith leis an neach-obrach companach. Le QUIRE_QUEUE_DRIVER=vercel air an neach-obrach companach, thèid na h-obraichean aotrom (lìbhrigeadh brathan is webhook gun òrdugh) tro Vercel Queues (VERCEL_QUEUE_REGION, VERCEL_QUEUE_TOKEN), agus cha dèanar polladh orra ann am Postgres cruinnichte
Obraichean ath-chuairteach Clàradair companach. Chan eil slighe Vercel Cron ann oir thigeadh ùine-ama gu crìch ma dhèanadh cron obair am broinn gnìomh
Tracadh OpenTelemetry don neach-cruinneachaidh agad, OTEL_EXPORTER_OTLP_ENDPOINT

Rudan nach urrainn don targaid seo a dhèanamh

Nì an t-sreath-lìn sgrùdadh orra seo aig àm tòiseachaidh agus diùlt i an rèiteachadh, ag ainmeachadh gach duilgheadas, seach fàilligeadh nas anmoiche nuair nach tèid a’ chiad phost-d a chur:

  • Gun SMTP. Bac Vercel SMTP a-mach. Suidhich QUIRE_EMAIL_PROVIDER_CONFIG gu solaraiche HTTP (Postmark, SES, Mailgun, SendGrid no Resend). Thèid QUIRE_SMTP_URL a dhiùltadh.
  • Gun diosg ionadail. Thèid QUIRE_STORAGE_DRIVER=local a dhiùltadh.
  • Gun chuimhne cho-roinnte eadar gairmean. Thèid QUIRE_REALTIME_DRIVER=inprocess a dhiùltadh. Tha tachartasan a chuirear leis an fhrithealaiche cuingichte ri ùine-ama na gnìomh; ath-cheanglaidh an cliant le cursair, agus mar sin cha tèid tachartas sam bith air chall, ach cha bhi làthaireachd ri fhaighinn.
  • Tha crìoch air stòran-dàta luchd-gabhail ceangailte, mu ochd dhiubh, oir tha cruinneachadh cheanglaichean eile aig gach fear ann an àrainneachd nach urrainn cruinneachaidhean a cho-roinn.

Cleachdadh

  1. Cruthaich pròiseact Vercel bhon ionad-stòrais le Root Directory apps/web. Suidhichidh apps/web/vercel.json na h-àitheantan stàlaidh is togail (NITRO_PRESET=vercel) agus fritheilidh e /sw.js gun thasgadh.
  2. Suidhich caochladairean na h-àrainneachd. Bho docker/.env.example, co-dhiù: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (seòladh a’ chruinniche), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, roghainnean an stòraidh, agus QUIRE_COLLAB_URL is QUIRE_COLLAB_SIGNING_KEY a’ comharrachadh seirbheis collab an aoigh chompanach. Buinidh QUIRE_REPORT_DATABASE_URL don stòr-dàta fiosaigeach a tha DATABASE_URL ag ainmeachadh. Airson gach stòr-dàta clàraichte a bharrachd, cuir a URL ceangail quire_report fhèin ri àrainneachdan web is worker, agus clàraich ainm caochladair na h-àrainneachd mar env:NAME ann an consol an àrd-ùrlair. Fàilligidh anailis dùinte mura h-eil URL aithisgean an stòir-dàta sin ann.
  3. Air an aoigh chompanach, ruith docker/compose.yaml às aonais seirbheis web, leis an aon docker/.env:
    docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
    Thèid na h-imrich a ruith an sin mus tèid gach cleachdadh Vercel àrdachadh.
  4. Cleachd. Ma dhiùltar rèiteachadh, tòisichidh log na gnìomh le “The web tier did not start on vercel” agus liostaichidh e gach suidheachadh ri atharrachadh.

Ùrachadh

Dèan imrich an toiseach bhon aoigh chompanach, cuir an gnìomh an cleachdadh Vercel ùr às a dhèidh agus an uair sin cuir luchd-obrach a’ chompanach air an tionndadh ùr, san òrdugh a tha ann an upgrade.md. ’S e tilleadh còd air ais a th’ ann an tilleadh sa bhad ann an Vercel, agus tha e an-còmhnaidh sàbhailte taobh a-staigh aon tionndaidh.

Seòladh

Sgrìobh airson lorg…

↑↓ gluais↵ taghEsc dùin