---
title: "Ny sehatra ve-dalana ao amin'ny Vercel"
description: "Mandeha amin'ny Vercel ny sehatra ve-dalana an'i Quire miaraka amin'ny mpandray anjara asa."
image: "https://docs.quirelms.com/og.png"
---

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

# Ny sehatra ve-dalana ao amin'ny Vercel

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

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 <!--quire:status-in-this-release-->

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 <!--quire:the-pieces-->

| 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 <!--quire:what-this-target-cannot-do-->

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 <!--quire:deploying-->

1. 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`.
2. 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.
3. Ao amin'ny mpandray anjara, alefa ny `docker/compose.yaml` tsy misy serivisy `web`, amin'ny `docker/.env` mitovy:
   ```sh
   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.
4. 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 <!--quire:upgrading-->

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](/mg/ops/upgrade/). Famerenana kaody ny famerenana haingana amin'ny Vercel, ary mahavita azy foana ao anatin'ny version iray.

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