Ny sehatra ve-dalana ao amin'ny Vercel

Mandeha amin'ny Vercel ny sehatra ve-dalana an'i Quire miaraka amin'ny mpandray anjara asa.

Ny drafitra dia ao amin’ny docs/architecture/23-ops.md singa 5. Ny sehatra ve-dalana ihany no asan’i Vercel. Zavatra hafa rehetra dia asan’ny mpandray anjara misokafanao, ary tsy safidy izany.

Toe-javatra amin’ity fametrahana ity

Efa misy ny fanitsakitsahana (apps/web/vercel.json, ny modely Nitro vercel ary ny fanamarinana fiaingana). Mila tahirin-rakitra zaraina ny Vercel (QUIRE_STORAGE_DRIVER=s3 na azure), mpitondra mivantana miasa eo amin’ny endrika tsirairay (QUIRE_REALTIME_DRIVER=sse na centrifugo) ary mpanome mailaka HTTP. Tsy misy izany dia tsy manomboka ny sehatra ve-dalana ary milaza ao amin’ny log ny filàlana tsy misy tsirairay.

Ny ampahany

Ampahany	Ahoana no asany
`web`	Vercel Functions, Bun runtime: pejy, REST, MCP, LTI, webhook voandray
`worker`, `scheduler`, `collab`, `content`	Mpandray anjara: Fly, Railway, ECS, na ny Docker-anao manokana amin’ny `docker/compose.yaml`
Postgres	Ivelany, eo aorian’ny mpampifandraisa: Neon, Supabase, na RDS amin’ny PgBouncer
Rakitra	S3 na R2. Tsy misy karatra miambina
Asa anaty	Alaina amin’ny pg-boss ao anatin’ny transaction an’ny fangatahana, asan’ny mpandray anjara asa. Amin’ny `QUIRE_QUEUE_DRIVER=vercel` eo amin’ny mpandray anjara asa, ny asa maivana (fandefasana fanambarana sy webhook tsy voafaritra) dia mandeha amin’ny Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), ka tsy misy fanadihadiana Postgres ho any
Asa manaraka	Ny mpandrinjaka mpandray anjara. Tsy misy lalan’ny Vercel Cron, satria ny cron miasa ao anatin’ny function dia manapa-t fotoana
Fanaraha-maso	OpenTelemetry mankany amin’ny mpangatakao, `OTEL_EXPORTER_OTLP_ENDPOINT`

Inona no tsy afakany io sehatra io

Mijery izany ny sehatra ve-dalana rehefa manomboka ary manala, manambara ny olana tsirairay, fa tsy diso eo amin’ny mailaka voalohany tsy alefa:

Tsy misy SMTP. Manakana ny SMTP mitohy ny Vercel. Metrahana QUIRE_EMAIL_PROVIDER_CONFIG amin’ny mpanome HTTP (Postmark, SES, Mailgun, SendGrid na Resend). Acomina ny QUIRE_SMTP_URL.
Tsy misy karatra anaty. Acomina ny QUIRE_STORAGE_DRIVER=local.
Tsy misy fizotra eo amin’ny fiantso. Acomina ny QUIRE_REALTIME_DRIVER=inprocess. Fetra amin’ny fotoanan’ny function ny zava-mitranga nalefan’ny serivera; mifandray indray amin’ny cursor ny client, ka tsy very zava-mitranga, fa tsy azo ampiasaina ny fisian’ny olona.
Fetra ny data-by mpanjifa voafaritra hatramin’ny eny faritra, satria pool fifandraisana hafa no ahitana azy ao amin’ny tontolo tsy afaka mizara pool.

Fampandrafiana

Mamorona tetikasa Vercel avy amin’ny repo amin’ny Root Directory apps/web. Ny apps/web/vercel.json no metrahana ny fehezanteny fampetrahana sy fampandrafana (NITRO_PRESET=vercel) ary mome amin’ny fomba tsy misy cache ny /sw.js.
Metrahana ny teny tontolo. Avy amin’ny docker/.env.example, farany: QUIRE_DEPLOY_TARGET=vercel, QUIRE_APP_ORIGIN, QUIRE_CONTENT_ORIGIN, QUIRE_PLATFORM_DOMAINS, QUIRE_SECRET_KEY, QUIRE_MASTER_KEY, DATABASE_URL (ny adiresin’ny mpampifandraisa), QUIRE_REPORT_DATABASE_URL, QUIRE_AUDIT_DATABASE_URL, QUIRE_DATABASE_ID, QUIRE_EMAIL_PROVIDER_CONFIG, QUIRE_MAIL_FROM, ny filàlana tahirin-rakitra, ary QUIRE_COLLAB_URL sy QUIRE_COLLAB_SIGNING_KEY mankany amin’ny serivisy collab an’ny mpandray anjara. Ny QUIRE_REPORT_DATABASE_URL dia akaikin’ny data-by ara-batana nosoratan’ny DATABASE_URL. Ho an’ny data-by voasoratra fanampiny tsirairay, ampio ny fifanarahan’ny quire_report manokany amin’ny tontolo web sy worker, avy eo horesen’ny anaran’ny tontolo ho env:NAME ao amin’ny konsolin’ny serivera. Tsy mahomby ny statistika raha very ny URL tatritry ny data-by io.
Ao amin’ny mpandray anjara, alefa ny docker/compose.yaml tsy misy serivisy web, amin’ny docker/.env mitovy:
```
docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
```
Asany ny fiovana ambadika ao indray, alohan’ny hanomezan’ny fampandrafiana Vercel tsirairay.
Fampandrafina. Amin’ny fanitsakitsahana acomina dia manomboka amin’ny “The web tier did not start on vercel” ny log an’ny function ary mizara ny filàlana tsirairay tokony hovanafina.

Fanavaozana

Fiovana avy amin’ny mpandray anjara voalohany, avy eo ny fampandrafiana Vercel vaovao, avy eo ny fanavaozana ny worker an’ny mpandray anjara: ny filaharana ao amin’ny upgrade.md. Famerenana kaody ny famerenana haingana amin’ny Vercel, ary mahavita azy foana ao anatin’ny version iray.