La dezajno troviĝas en sekcio 5 de docs/architecture/23-ops.md. Vercel rulas nur la retan
tavolon. Ĉio alia funkcias ĉe akompana gastiganto mastrumata de vi; ĝi estas
deviga.
Stato en ĉi tiu eldono
La agordo jam ekzistas (apps/web/vercel.json, la Nitro-antaŭagordo
vercel kaj startkontroloj). Vercel bezonas komunan dosierstokadon
(QUIRE_STORAGE_DRIVER=s3 aŭ azure), realtempan pelilon kiu funkcias tra
funkci-instancoj (QUIRE_REALTIME_DRIVER=sse aŭ centrifugo) kaj HTTP-
retpoŝtprovizanton. Sen ili la reta tavolo rifuzas starti kaj ĝia protokolo
nomas ĉiun mankantan agordon.
La partoj
Parto
Kie ĝi ruliĝas
web
Vercel Functions, Node-rultempo: paĝoj, REST, MCP, LTI kaj ricevitaj webhooks
worker, scheduler, collab, content
Akompana gastiganto: Fly, Railway, ECS aŭ via propra Docker-gastiganto kun docker/compose.yaml
Postgres
Ekstera, malantaŭ transakcia kunigilo: Neon, Supabase aŭ RDS kun PgBouncer
Dosieroj
S3 aŭ R2. Ne ekzistas persista disko
Fonaj taskoj
Envicigitaj per pg-boss ene de la transakcio de peto, kaj rulitaj de akompana worker. Kun QUIRE_QUEUE_DRIVER=vercel ĉe akompana worker, malpezaj taskoj (senorda livero de sciigoj kaj webhooks) trairas Vercel Queues (VERCEL_QUEUE_REGION, VERCEL_QUEUE_TOKEN), do ili ne pridemandiĝas de la kunigita Postgres
Ripetiĝantaj taskoj
La akompana planilo. Ne ekzistas Vercel Cron-vojo, ĉar cron faranta laboron ene de funkcio eltempas
Spuradon
OpenTelemetry al via kolektilo, OTEL_EXPORTER_OTLP_ENDPOINT
Kion ĉi tiu celo ne povas fari
La reta tavolo kontrolas jenon ĉe starto kaj rifuzas, nomante ĉiun problemon,
anstataŭ malsukcesi poste kiam la unua retpoŝto ne sendiĝas:
Neniu SMTP. Vercel blokas eliran SMTP. Agordu QUIRE_EMAIL_PROVIDER_CONFIG
al HTTP-provizanto (Postmark, SES, Mailgun, SendGrid aŭ Resend).
QUIRE_SMTP_URL estas rifuzata.
Neniu loka disko.QUIRE_STORAGE_DRIVER=local estas rifuzata.
Neniu komuna memoro inter alvokoj.QUIRE_REALTIME_DRIVER=inprocess
estas rifuzata. Server-sent events estas limigitaj de funkcia tempolimo; la
kliento rekonektiĝas per kurzoro, do eventoj ne perdiĝas, sed ĉeesto ne
disponeblas.
Luantaj datumbazoj fiksitaj al aparta servilo limiĝas al proksimume ok, ĉar ĉiu estas
plia konektolageto en medio kie oni ne povas kunhavi lagetojn.
Disfaldi
Kreu Vercel-projekton el la deponejo kun Root Directory
agordita al apps/web. apps/web/vercel.json difinas instalajn kaj konstruajn komandojn
(NITRO_PRESET=vercel) kaj liveras /sw.js sen kaŝmemoro.
Agordu mediovariablojn. El docker/.env.example, minimume:
QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN,
QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY,
DATABASE_URL (la adreso de kunigilo), QUIRE_REPORT_DATABASE_URL,
QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID,
QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, stokagordoj,
kaj QUIRE_COLLAB_URL kaj QUIRE_COLLAB_SIGNING_KEY indikantaj al la
collab-servo de la akompana gastiganto.
QUIRE_REPORT_DATABASE_URL apartenas al la fizika datumbazo nomita per
DATABASE_URL. Por ĉiu plia registrita datumbazo, aldonu ĝian propran
quire_report-konektotringon al retaj kaj worker-medioj, poste
registru ĝian mediovariablan nomon kiel env:NAME en la platforma
konzolo. Analizo sekure malsukcesas se mankas la raport-URL de tiu datumbazo.
Ĉe akompana gastiganto rulu docker/compose.yaml sen la servo web,
kun sama docker/.env:
Migradoj ruliĝas tie antaŭ ol ĉiu Vercel-disloko estas aktivigita.
Disfaldigu. Se agordo estas rifuzita, funkcia protokolo komenciĝas per “The web
tier did not start on vercel” kaj listigas ĉiun ŝanĝendan agordon.
Ĝisdatigi
Unue migru ĉe la akompana gastiganto, poste aktivigu la novan Vercel-
disfaldaĵon kaj laste ruligu la workers de la akompana gastiganto, laŭ la ordo en
upgrade.md. Tuja Vercel-reiro al antaŭa versio estas koda reiro kaj
ĉiam sekura ene de eldono.