---
title: "Web tier la sou Vercel"
description: "Kouri web tier Quire sou Vercel ak yon worker konpayon."
image: "https://docs.quirelms.com/og.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.quirelms.com/ht/llms.txt
> Use this file to discover all available pages before exploring further.

# Web tier la sou Vercel

<span id="the-web-tier-on-vercel"></span>

Konsepsyon an nan `docs/architecture/23-ops.md`, seksyon 5. Vercel kouri web tier la sèlman. Tout lòt sèvis yo kouri sou yon host konpayon ou opere, epi yo pa opsyonèl.

## Estati nan vèsyon sa a <!--quire:status-in-this-release-->

Konfigirasyon an pare (`apps/web/vercel.json`, preset Nitro `vercel` ak verifikasyon demaraj yo). Vercel bezwen depo fichye pataje (`QUIRE_STORAGE_DRIVER=s3` oswa `azure`), driver reyalite-a-kounye a ki mache nan plizyè enstans fonksyon (`QUIRE_REALTIME_DRIVER=sse` oswa `centrifugo`) ak yon founisè imèl HTTP. San yo, web tier la refize kòmanse, epi log li bay non chak paramèt ki manke.

## Konpozan yo <!--quire:the-pieces-->

| Konpozan | Kote li kouri |
| --- | --- |
| `web` | Vercel Functions, anviwònman Node: paj, REST, MCP, LTI ak webhook li resevwa |
| `worker`, `scheduler`, `collab`, `content` | Yon host konpayon: Fly, Railway, ECS oswa host Docker pa w ki sèvi ak `docker/compose.yaml` |
| Postgres | Deyò, dèyè yon pooler transaction: Neon, Supabase oswa RDS ak PgBouncer |
| Fichye | S3 oswa R2. Pa gen disk ki dire lontan |
| Travay an aryè-plan | Yo mete nan ke ak pg-boss anndan transaction demann nan, epi worker konpayon an kouri yo. Si worker konpayon an gen `QUIRE_QUEUE_DRIVER=vercel`, travay lejè yo (notifikasyon san lòd ak livrezon webhook) pase nan Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), konsa Postgres ki nan pool lan pa sonde pou travay sa yo |
| Travay peryodik | Scheduler konpayon an. Pa gen route Vercel Cron paske yon cron k ap fè travay anndan yon fonksyon ta fini pa ekspire |
| Trase | OpenTelemetry pou collector pa w la, `OTEL_EXPORTER_OTLP_ENDPOINT` |

## Sa sib sa a pa kapab fè <!--quire:what-this-target-cannot-do-->

Web tier la verifye sa lè li kòmanse epi li refize konfigirasyon ki pa mache, pandan li bay non chak pwoblèm. Konsa, li pa tann jiskaske premye imèl li pa ka voye a:

- **Pa gen SMTP.** Vercel bloke SMTP k ap soti. Mete `QUIRE_EMAIL_PROVIDER_CONFIG` sou yon founisè HTTP (Postmark, SES, Mailgun, SendGrid oswa Resend). Yo refize `QUIRE_SMTP_URL`.
- **Pa gen disk lokal.** Yo refize `QUIRE_STORAGE_DRIVER=local`.
- **Pa gen memwa pataje ant envokasyon.** Yo refize `QUIRE_REALTIME_DRIVER=inprocess`. Evènman ki soti nan sèvè sèvi ak fonksyon ki gen limit tan an; client la rekonekte ak yon cursor pou okenn evènman pa pèdi, men pa gen enfòmasyon prezans.
- **Kantite tenant bazdone fikse limite** a anviwon uit paske chak lòt tenant ajoute yon pool koneksyon nan yon anviwònman ki pa kapab pataje pool yo.

## Deplwaye <!--quire:deploying-->

1. Kreye yon pwojè Vercel apati repozitwa a avèk **Root Directory** `apps/web`. `apps/web/vercel.json` fikse kòmand pou enstalasyon ak konstriksyon (`NITRO_PRESET=vercel`) epi sèvi `/sw.js` san kach.
2. Mete varyab anviwònman yo. Soti nan `docker/.env.example`, mete omwen: `QUIRE_DEPLOY_TARGET=vercel`, `QUIRE_APP_ORIGIN`, `QUIRE_CONTENT_ORIGIN`, `QUIRE_PLATFORM_DOMAINS`, `QUIRE_SECRET_KEY`, `QUIRE_MASTER_KEY`, `DATABASE_URL` (adrès pooler la), `QUIRE_REPORT_DATABASE_URL`, `QUIRE_AUDIT_DATABASE_URL`, `QUIRE_DATABASE_ID`, `QUIRE_EMAIL_PROVIDER_CONFIG`, `QUIRE_MAIL_FROM`, paramèt depo yo, ansanm ak `QUIRE_COLLAB_URL` ak `QUIRE_COLLAB_SIGNING_KEY` ki montre sèvis collab host konpayon an.
   `QUIRE_REPORT_DATABASE_URL` dwe konekte ak bazdone fizik `DATABASE_URL` nonmen an. Pou chak lòt bazdone anrejistre, ajoute pwòp URL koneksyon `quire_report` pa li nan anviwònman web ak worker yo, epi anrejistre non varyab anviwònman sa a kòm `env:NAME` nan konsole platfòm nan. Analytics pa mache si URL rapò bazdone sa a manke.
3. Sou host konpayon an, kouri `docker/compose.yaml` san sèvis `web`, ak menm `docker/.env` la:
   ```sh
   docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
   ```
   Migration yo kouri la anvan yo deplwaye chak nouvo vèsyon Vercel.
4. Deplwaye. Si konfigirasyon an refize, log fonksyon an kòmanse ak "The web tier did not start on vercel" epi li bay lis paramèt pou chanje.

## Mete ajou <!--quire:upgrading-->

Premyèman fè migration apati host konpayon an, answit aktive nouvo deplwaman Vercel la, epi apre sa fè worker konpayon yo woule nan nouvo vèsyon an: se lòd ki nan [upgrade.md](/ht/ops/upgrade/). Retounen tousuit nan yon deplwaman Vercel se retounen nan kòd anndan menm vèsyon an, epi sa toujou san danje.

Source: https://docs.quirelms.com/ht/ops/vercel/index.mdx