---
title: "An tsraith ghréasáin ar Vercel"
description: "Rith tsraith ghréasáin Quire ar Vercel le próiseálaí compánach."
image: "https://docs.quirelms.com/og.png"
---

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

# An tsraith ghréasáin ar Vercel

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

Tá an dearadh in alt 5 de `docs/architecture/23-ops.md`. Ní ritheann Vercel ach an tsraith ghréasáin. Ritheann gach rud eile ar óstach compánach a oibríonn tú, agus níl sé roghnach.

## Stádas san eisiúint seo <!--quire:status-in-this-release-->

Tá an chumraíocht curtha i bhfeidhm (`apps/web/vercel.json`, réamhshocrú Nitro `vercel` agus seiceálacha tosaithe). Teastaíonn stóráil comhad chomhroinnte ó Vercel (`QUIRE_STORAGE_DRIVER=s3` nó `azure`), tiománaí fíor-ama a oibríonn trasna cásanna feidhme (`QUIRE_REALTIME_DRIVER=sse` nó `centrifugo`), agus soláthraí ríomhphoist HTTP. Gan iad, diúltaíonn an tsraith ghréasáin tosú agus ainmníonn a log gach socrú atá ar iarraidh.

## Na comhpháirteanna <!--quire:the-pieces-->

| Comhpháirt | Áit a ritheann sí |
| --- | --- |
| `web` | Vercel Functions, rite-ama Node: leathanaigh, REST, MCP, LTI agus webhooks a fhaightear |
| `worker`, `scheduler`, `collab`, `content` | Óstach compánach: Fly, Railway, ECS nó d'óstach Docker féin le `docker/compose.yaml` |
| Postgres | Seachtrach, taobh thiar de chomhthiomsaitheoir idirbheart: Neon, Supabase nó RDS le PgBouncer |
| Comhaid | S3 nó R2. Níl diosca leanúnach ann |
| Jabanna cúlra | Cuirtear sa scuaine pg-boss iad san idirbheart iarratais agus ritheann an próiseálaí compánach iad. Le `QUIRE_QUEUE_DRIVER=vercel` ar an bpróiseálaí compánach, téann jabanna éadroma (seachadtaí fógraí agus webhook nach bhfuil ordaithe) trí Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), ionas nach ndéantar vótáil orthu sa Postgres comhthiomsaithe |
| Jabanna athfhillteacha | Sceidealóir an óstaigh chompánaigh. Níl bealach Vercel Cron ann, mar théann cron a dhéanann obair taobh istigh d'fheidhm thar am istigh |
| Rianú | OpenTelemetry chuig do bhailitheoir, `OTEL_EXPORTER_OTLP_ENDPOINT` |

## Rudaí nach féidir leis an sprioc seo a dhéanamh <!--quire:what-this-target-cannot-do-->

Seiceálann an tsraith ghréasáin iad seo ar an tosú agus diúltaíonn sí, agus ainmníonn sí gach fadhb, in áit teip níos déanaí nuair nach seoltar an chéad ríomhphost:

- **Níl SMTP ar fáil.** Cuireann Vercel bac ar SMTP amach. Socraigh `QUIRE_EMAIL_PROVIDER_CONFIG` ar sholáthraí HTTP (Postmark, SES, Mailgun, SendGrid nó Resend). Diúltaítear do `QUIRE_SMTP_URL`.
- **Níl diosca áitiúil ar fáil.** Diúltaítear do `QUIRE_STORAGE_DRIVER=local`.
- **Níl cuimhne chomhroinnte idir glaonna.** Diúltaítear do `QUIRE_REALTIME_DRIVER=inprocess`. Tá sruthanna seolta imeachtaí teoranta d'am feidhme; athcheanglaíonn an cliant le cúrsóir, mar sin ní chailltear imeacht, ach níl láithreacht ar fáil.
- **Tá líon na mbunachar sonraí tionónta pionnáilte teoranta** do thart ar ocht gcinn, mar gurb ionann gach ceann breise agus comhthiomsú ceangail eile i dtimpeallacht nach féidir leo comhthiomsuithe a roinnt.

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

1. Cruthaigh tionscadal Vercel ón stór leis an **Root Directory** socraithe mar `apps/web`. Socraíonn `apps/web/vercel.json` orduithe suiteála agus tógála (`NITRO_PRESET=vercel`) agus freastalaíonn sé ar `/sw.js` gan taisce.
2. Socraigh athróga timpeallachta. Ó `docker/.env.example`, teastaíonn ar a laghad: `QUIRE_DEPLOY_TARGET=vercel`, `QUIRE_APP_ORIGIN`, `QUIRE_CONTENT_ORIGIN`, `QUIRE_PLATFORM_DOMAINS`, `QUIRE_SECRET_KEY`, `QUIRE_MASTER_KEY`, `DATABASE_URL` (seoladh an chomhthiomsaitheora), `QUIRE_REPORT_DATABASE_URL`, `QUIRE_AUDIT_DATABASE_URL`, `QUIRE_DATABASE_ID`, `QUIRE_EMAIL_PROVIDER_CONFIG`, `QUIRE_MAIL_FROM`, socruithe stórála, agus `QUIRE_COLLAB_URL` agus `QUIRE_COLLAB_SIGNING_KEY` dírithe ar sheirbhís collab an óstaigh chompánaigh.
   Baineann `QUIRE_REPORT_DATABASE_URL` leis an mbunachar sonraí fisiciúil atá ainmnithe ag `DATABASE_URL`. I gcás gach bunachair chláraithe bhreise, cuir a URL ceangail `quire_report` féin le timpeallachtaí web agus worker, ansin cláraigh ainm a athróige timpeallachta mar `env:NAME` i gconsól an ardáin. Teipeann anailísíocht dúnta mura bhfuil URL tuairiscithe an bhunachair sin ann.
3. Ar an óstach compánach, rith `docker/compose.yaml` gan an tseirbhís `web`, agus úsáid an `docker/.env` céanna:
   ```sh
   docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
   ```
   Ritheann aistrithe ansin, sula gcuirtear gach imscaradh Vercel chun cinn.
4. Déan imscaradh. Má dhiúltaítear don chumraíocht, tosaíonn log na feidhme le "The web tier did not start on vercel" agus liostaíonn sé gach socrú atá le hathrú.

## Uasghrádú <!--quire:upgrading-->

Rith aistriú ón óstach compánach ar dtús, ansin cuir imscaradh nua Vercel chun cinn, agus ar deireadh rollaigh próiseálaithe an chompánaigh: seo an t-ord in [upgrade.md](/ga/ops/upgrade/). Is filleadh ar chód é filleadh láithreach Vercel agus bíonn sé sábháilte i gcónaí laistigh d'eisiúint.

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