---
title: "An t-sreath-lìn air Vercel"
description: "Ruith an t-sreath-lìn Quire air Vercel le pròiseas-obrach companach."
image: "https://docs.quirelms.com/og.png"
---

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

# An t-sreath-lìn air Vercel

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

Tha an dealbhadh aig earrann 5 de `docs/architecture/23-ops.md`. Chan eil Vercel a’ ruith ach an t-sreath-lìn. Tha a h-uile càil eile air aoigh companach a tha thu ag obrachadh, agus tha sin riatanach.

## Inbhe san tionndadh seo <!--quire:status-in-this-release-->

Tha an rèiteachadh deiseil (`apps/web/vercel.json`, ro-shuidheachadh Nitro `vercel` agus na sgrùdaidhean tòiseachaidh). Feumaidh Vercel stòradh fhaidhlichean co-roinnte (`QUIRE_STORAGE_DRIVER=s3` no `azure`), draibhear fìor-ùine a dh’obraicheas thar eisimpleirean ghnìomhan (`QUIRE_REALTIME_DRIVER=sse` no `centrifugo`) agus solaraiche post-d HTTP. Mura h-eil iad ann, diùltas an t-sreath-lìn tòiseachadh agus ainmichidh an log gach roghainn a tha a dhìth.

## Na pìosan <!--quire:the-pieces-->

| Pìos | Càit an ruith e |
| --- | --- |
| `web` | Vercel Functions, àm-ruith Node: duilleagan, REST, MCP, LTI, webhooks a gheibhear |
| `worker`, `scheduler`, `collab`, `content` | Aoigh companach: Fly, Railway, ECS no aoigh Docker agad fhèin le `docker/compose.yaml` |
| Postgres | Taobh a-muigh, air cùl cruinniche ghnothaichean: Neon, Supabase no RDS le PgBouncer |
| Faidhlichean | S3 no R2. Chan eil diosg mhaireannach ann |
| Obraichean cùl-raoin | Air an cur sa chiudha le pg-boss am broinn gnothach an iarrtais agus air an ruith leis an neach-obrach companach. Le `QUIRE_QUEUE_DRIVER=vercel` air an neach-obrach companach, thèid na h-obraichean aotrom (lìbhrigeadh brathan is webhook gun òrdugh) tro Vercel Queues (`VERCEL_QUEUE_REGION`, `VERCEL_QUEUE_TOKEN`), agus cha dèanar polladh orra ann am Postgres cruinnichte |
| Obraichean ath-chuairteach | Clàradair companach. Chan eil slighe Vercel Cron ann oir thigeadh ùine-ama gu crìch ma dhèanadh cron obair am broinn gnìomh |
| Tracadh | OpenTelemetry don neach-cruinneachaidh agad, `OTEL_EXPORTER_OTLP_ENDPOINT` |

## Rudan nach urrainn don targaid seo a dhèanamh <!--quire:what-this-target-cannot-do-->

Nì an t-sreath-lìn sgrùdadh orra seo aig àm tòiseachaidh agus diùlt i an rèiteachadh, ag ainmeachadh gach duilgheadas, seach fàilligeadh nas anmoiche nuair nach tèid a’ chiad phost-d a chur:

- **Gun SMTP.** Bac Vercel SMTP a-mach. Suidhich `QUIRE_EMAIL_PROVIDER_CONFIG` gu solaraiche HTTP (Postmark, SES, Mailgun, SendGrid no Resend). Thèid `QUIRE_SMTP_URL` a dhiùltadh.
- **Gun diosg ionadail.** Thèid `QUIRE_STORAGE_DRIVER=local` a dhiùltadh.
- **Gun chuimhne cho-roinnte eadar gairmean.** Thèid `QUIRE_REALTIME_DRIVER=inprocess` a dhiùltadh. Tha tachartasan a chuirear leis an fhrithealaiche cuingichte ri ùine-ama na gnìomh; ath-cheanglaidh an cliant le cursair, agus mar sin cha tèid tachartas sam bith air chall, ach cha bhi làthaireachd ri fhaighinn.
- **Tha crìoch air stòran-dàta luchd-gabhail ceangailte**, mu ochd dhiubh, oir tha cruinneachadh cheanglaichean eile aig gach fear ann an àrainneachd nach urrainn cruinneachaidhean a cho-roinn.

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

1. Cruthaich pròiseact Vercel bhon ionad-stòrais le **Root Directory** `apps/web`. Suidhichidh `apps/web/vercel.json` na h-àitheantan stàlaidh is togail (`NITRO_PRESET=vercel`) agus fritheilidh e `/sw.js` gun thasgadh.
2. Suidhich caochladairean na h-àrainneachd. Bho `docker/.env.example`, co-dhiù: `QUIRE_DEPLOY_TARGET=vercel`, `QUIRE_APP_ORIGIN`, `QUIRE_CONTENT_ORIGIN`, `QUIRE_PLATFORM_DOMAINS`, `QUIRE_SECRET_KEY`, `QUIRE_MASTER_KEY`, `DATABASE_URL` (seòladh a’ chruinniche), `QUIRE_REPORT_DATABASE_URL`, `QUIRE_AUDIT_DATABASE_URL`, `QUIRE_DATABASE_ID`, `QUIRE_EMAIL_PROVIDER_CONFIG`, `QUIRE_MAIL_FROM`, roghainnean an stòraidh, agus `QUIRE_COLLAB_URL` is `QUIRE_COLLAB_SIGNING_KEY` a’ comharrachadh seirbheis collab an aoigh chompanach.
   Buinidh `QUIRE_REPORT_DATABASE_URL` don stòr-dàta fiosaigeach a tha `DATABASE_URL` ag ainmeachadh. Airson gach stòr-dàta clàraichte a bharrachd, cuir a URL ceangail `quire_report` fhèin ri àrainneachdan web is worker, agus clàraich ainm caochladair na h-àrainneachd mar `env:NAME` ann an consol an àrd-ùrlair. Fàilligidh anailis dùinte mura h-eil URL aithisgean an stòir-dàta sin ann.
3. Air an aoigh chompanach, ruith `docker/compose.yaml` às aonais seirbheis `web`, leis an aon `docker/.env`:
   ```sh
   docker compose -f docker/compose.yaml up -d migrate init worker scheduler collab content
   ```
   Thèid na h-imrich a ruith an sin mus tèid gach cleachdadh Vercel àrdachadh.
4. Cleachd. Ma dhiùltar rèiteachadh, tòisichidh log na gnìomh le “The web tier did not start on vercel” agus liostaichidh e gach suidheachadh ri atharrachadh.

## Ùrachadh <!--quire:upgrading-->

Dèan imrich an toiseach bhon aoigh chompanach, cuir an gnìomh an cleachdadh Vercel ùr às a dhèidh agus an uair sin cuir luchd-obrach a’ chompanach air an tionndadh ùr, san òrdugh a tha ann an [upgrade.md](/gd/ops/upgrade/). ’S e tilleadh còd air ais a th’ ann an tilleadh sa bhad ann an Vercel, agus tha e an-còmhnaidh sàbhailte taobh a-staigh aon tionndaidh.

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